杰瑞科技汇

Blender Python版本如何升级或兼容?

核心结论(一句话总结)

Blender 内置的 Python 版本与其主版本号强绑定,Blender 4.x 使用 Python 3.10,Blender 3.x 使用 Python 3.7,以此类推。

Blender Python版本如何升级或兼容?-图1
(图片来源网络,侵删)

详细版本对应关系

以下是 Blender 2.8 及更高版本与 Python 版本的详细对应表:

Blender 版本 内置 Python 版本 备注
Blender 4.x Python 3.10 当前及未来版本的标准
Blender 3.6 Python 3.10 从 3.6 开始统一升级到 3.10
Blender 3.5 Python 3.10
Blender 3.4 Python 3.10
Blender 3.3 Python 3.10
Blender 3.2 Python 3.10
Blender 3.0 & 3.1 Python 3.9
Blender 2.93 Python 3.9
Blender 2.92 Python 3.9
Blender 2.91 Python 3.9
Blender 2.90 Python 3.7
Blender 2.83 - 2.89 Python 3.7
Blender 2.8x (LTS) Python 3.7

关键点:

  1. 固定捆绑:Blender 将特定版本的 Python 解释器打包在一起,你无法在 Blender 中使用系统安装的其他 Python 版本(你电脑上装的 Python 3.11 或 3.12 在 Blender 内部是不可见的)。
  2. 脚本兼容性:这意味着你为 Blender 编写的任何脚本都必须使用与其内置 Python 版本兼容的语法和库,一个使用了 Python 3.8 特性(如 海象运算符)的脚本,在 Blender 2.93(Python 3.7)上运行时会直接报错。
  3. Blender API:你通过 import bpy 导入的 bpy 模块,以及所有相关的 Blender Python API,都是专门为这个捆绑的 Python 版本编译的,这是你与 Blender 交互的核心。

如何在 Blender 中确认 Python 版本?

最简单的方法是在 Blender 的 Python 控制台或脚本编辑器中运行以下代码:

import sys
print(sys.version)

输出示例 (在 Blender 4.0 中):

Blender Python版本如何升级或兼容?-图2
(图片来源网络,侵删)
10.12 (main, Nov 20 2025, 15:14:05) [GCC 13.2.1 20250801]

这个输出清晰地告诉你当前 Blender 环境所使用的 Python 版本。


对 Blender 开发者/脚本作者的影响

了解这个对应关系对你的工作至关重要。

脚本兼容性(最重要)

  • 目标平台:在编写脚本时,你必须明确你的脚本是为哪个 Blender 版本开发的,从而确定你应使用的 Python 版本。
  • 向后兼容:如果你的脚本需要支持多个 Blender 版本(一个从 Blender 3.0 到 4.0 都能用的插件),你就必须使用这些版本中最低的 Python 版本(即 Python 3.7)的特性。
  • 新特性使用:如果你只为最新的 Blender 4.x 开发,那么你可以放心地使用 Python 3.10 的所有新特性,如 match-case 语句、union 类型提示等。

使用外部库(Pip)

Blender 的 Python 环境是独立的,你可以使用 pip 来安装第三方库,但这些库只对 Blender 内部的 Python 有效

如何安装外部库?

Blender Python版本如何升级或兼容?-图3
(图片来源网络,侵删)
  1. 在命令行中定位 Blender 的 Python:

    • Windows: 打开命令提示符或 PowerShell,进入 Blender 的安装目录,然后进入 X.X\X.X\python\bin 文件夹。
    • macOS: 打开终端,进入 Blender 的应用包,路径是 Blender.app/Contents/MacOS/python/bin
    • Linux: /usr/bin/blender 会是一个软链接,你需要找到实际的 blender 可执行文件,然后在其同级目录下的 X.X/python/bin 中找到。
  2. 使用 pip 安装: 在上述 bin 目录下,你会看到一个 pippip3 的可执行文件,使用它来安装库。

    示例 (Windows):

    # 假设你的 Blender 4.0 安装在 C:\Program Files\Blender Foundation\Blender 4.0
    cd "C:\Program Files\Blender Foundation\Blender 4.0\4.0\python\bin"
    # 安装 numpy
    pip install numpy

    示例 (macOS):

    # 假设你的 Blender 4.0 在 /Applications/Blender.app
    cd /Applications/Blender.app/Contents/MacOS/4.0/python/bin
    # 安装 requests
    pip install requests

注意:安装的库会存放在 Blender 的 Python 环境的 site-packages 目录下,这个路径同样可以通过 import sys; print(sys.path) 在 Blender 中查看。

打包和分发

当你打包你的 Blender 插件(制作一个 .zip 文件分发)时,不需要包含 Python 解释器或你安装的库,你的依赖库需要通过 requirements.txt 文件说明,让用户自行按照上述方法安装。


方面 说明
版本绑定 Blender 版本决定其内置的 Python 版本,无法更改。
脚本编写 脚本必须与目标 Blender 版本的 Python 版本兼容。
外部库 使用 Blender 自带的 pip 安装,库仅对 Blender 内部环境有效。
开发建议 为多个 Blender 版本开发时,请使用最低兼容的 Python 版本特性。

记住这个核心原则:Blender 带来了它自己的 Python 世界,你的所有开发活动都在这个世界里进行。

分享:
扫描分享到社交APP
上一篇
下一篇