blender

项目地址： https://github.com/blender/blender

官方文档： https://docs.blender.org/

Python API： https://docs.blender.org/api/current/

许可证： GPL-2.0-or-later

包管理器： winget install BlenderFoundation.Blender / brew install --cask blender / sudo snap install blender --classic（最新 5.2.3，截至 2026-10）

版本： 5.2.3（2026-10-22；5.2 为 LTS 系列，见 https://download.blender.org/release/Blender5.2/）

概述

Blender 是开源 3D 创作套件，通过内置 Python 解释器暴露完整的 bpy API：脚本可读写全部场景数据、调用几乎全部界面功能，适合程序化建模、GIS 数据三维化与无头批处理。Python API 随 Blender 版本发布（当前 5.2.3，5.2 为 LTS 系列），无需单独安装。

核心模块：

模块	用途
bpy.data	数据块访问（objects、meshes、materials、node_groups…）
bpy.context	当前上下文（场景、视图层、选中对象、模式）
bpy.ops	操作符（建模、导入导出、渲染、文件管理）
bpy.types	类型定义（Object、Mesh、Operator、NodeTree…）
bpy.msgbus	消息总线（订阅数据块属性变更）
mathutils	Vector / Matrix / Quaternion / Euler 数学库
bpy_extras	辅助工具（io_utils、object_utils、view3d_utils）

常用交换格式：.blend、glTF 2.0（.gltf/.glb）、OBJ、STL、FBX、PLY、USD、Alembic、SVG。

---

环境准备

桌面安装

# Windows：官网安装包或 winget
winget install BlenderFoundation.Blender

# macOS
brew install --cask blender

# Linux（Ubuntu 官方推荐 snap）
sudo snap install blender --classic
# 或使用官网 tar.xz（免 root）：<https://www.blender.org/download/>
# 发行版仓库的 blender 包通常滞后于官网版本，建议 snap 或官网包

无头（headless）运行

• blender -b（--background）不创建窗口，渲染、导入导出、脚本执行均可用，适合服务器与 CI。
• 无头环境不需要显示器；Linux 服务器建议使用官网 tar.xz 并补齐基础运行库。
• Blender 内置独立 Python，不依赖系统 Python；脚本中直接 import bpy 即可。

验证

blender --version
blender -b --python-expr "import bpy; print(bpy.app.version_string)"

---

核心 API/命令

命令行运行脚本

blender -b scene.blend -P build.py                 # 打开文件并执行脚本
blender -b -P gen.py -- --count 100 --out out.glb  # 脚本参数置于 -- 之后，脚本内用 sys.argv 读取
blender -b --python-expr "import bpy; print(len(bpy.data.objects))"
blender -b --python-exit-code 1 -P pipeline.py     # 脚本异常时以非零码退出，便于 CI 判断

-P 等价于 --python <filepath>；另有 --python-text <name>（执行文本块）与 --python-console（交互控制台）。