核心结论(一句话总结)
Blender 内置的 Python 版本与其主版本号强绑定,Blender 4.x 使用 Python 3.10,Blender 3.x 使用 Python 3.7,以此类推。

详细版本对应关系
以下是 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 |
关键点:
- 固定捆绑:Blender 将特定版本的 Python 解释器打包在一起,你无法在 Blender 中使用系统安装的其他 Python 版本(你电脑上装的 Python 3.11 或 3.12 在 Blender 内部是不可见的)。
- 脚本兼容性:这意味着你为 Blender 编写的任何脚本都必须使用与其内置 Python 版本兼容的语法和库,一个使用了 Python 3.8 特性(如 海象运算符)的脚本,在 Blender 2.93(Python 3.7)上运行时会直接报错。
- Blender API:你通过
import bpy导入的bpy模块,以及所有相关的 Blender Python API,都是专门为这个捆绑的 Python 版本编译的,这是你与 Blender 交互的核心。
如何在 Blender 中确认 Python 版本?
最简单的方法是在 Blender 的 Python 控制台或脚本编辑器中运行以下代码:
import sys print(sys.version)
输出示例 (在 Blender 4.0 中):

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:
- 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中找到。
- Windows: 打开命令提示符或 PowerShell,进入 Blender 的安装目录,然后进入
-
使用 pip 安装: 在上述
bin目录下,你会看到一个pip或pip3的可执行文件,使用它来安装库。示例 (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 世界,你的所有开发活动都在这个世界里进行。
