VSCode 无法预览 Blender 3D 效果，但可通过 fake-bpy-module 补全 bpy、Blender Development 插件注入脚本、开启系统控制台查看输出、手动重载模块及注意上下文依赖来高效开发调试。
VSCode 本身不能预览 Blender 的 3D 效果，但可以高效编写、运行、调试脚本，并实时看到结果在 Blender 窗口中渲染出来——关键在于打通 VSCode 与 Blender 的通信链路，而不是“预览”。
如何让 VSCode 正确识别 bpy 并获得补全
Blender 的 bpy 模块是运行时动态生成的，标准 Python 环境里根本不存在，所以 VSCode 默认会标红所有 bpy. 调用。不配 fake-bpy-module，写一行报十行错。
- 去 fake-bpy-module GitHub 下载对应 Blender 版本的 release（比如你用的是 Blender 4.3，就下
fake-bpy-module-4.3） - 解压后，在 VSCode 设置中添加两个路径：
"python.autoComplete.extraPaths"和"python.analysis.extraPaths"都指向解压后的fake_bpy_module文件夹 - 重启 VSCode，再输入
bpy.ops.mesh.就能弹出完整函数列表了 - 别用在线生成方式——它依赖 pip，而 Blender 自带的 Python 不走系统 pip，极易失败
bpy.ops 脚本在 VSCode 中运行失败的常见原因
你在 VSCode 里点“运行”却提示 ModuleNotFoundError: No module named 'bpy' 或 RuntimeError: Operator bpy.ops.mesh.primitive_cube_add can only be called from the main thread，说明没走对通道。
- 绝对不要直接在终端里执行
python my_script.py——这调用的是系统 Python，不是 Blender 的 Python - 正确做法是用
Blender: Run Script命令（Ctrl+Shift+P → 输入该命令），它会把脚本注入当前运行的 Blender 实例 - 如果没看到这个命令，说明没装
Blender Development插件，或没配置blender.executable路径（Windows 示例：C:\Program Files\Blender Foundation\Blender 4.3\blender.exe） - 确保 Blender 已启动且未卡死；脚本运行时 Blender 界面会短暂卡顿，这是正常现象
调试时看不到 print 输出？打开系统控制台
Blender 默认不显示 Python 的 print 或错误 traceback，所有输出都扔进黑盒。不打开控制台，等于蒙眼修车。
立即学习“Python免费学习笔记（深入）”；
- 在 Blender 菜单栏：Window → Toggle System Console（Windows/macOS）或 Window → Show System Console（Linux）
- 之后每次运行脚本，
print("hello")和AttributeError都会实时出现在这个窗口里 - 如果你用
bpy.context.scene.objects取对象却返回空列表，控制台大概率会告诉你RuntimeError: Operator not allowed in current context——这时要检查是否在正确的模式下（比如编辑模式下不能调bpy.ops.object.delete） - 别依赖 VSCode 的 Debug Console 输出，它和 Blender 的 Python 运行环境是隔离的
为什么改了代码却没生效？注意模块缓存和重载
Blender 会缓存已导入的 Python 模块。你改完 operators/mesh_ops.py，重新运行脚本，它可能还在用旧版本的函数。
- 手动重载：在脚本开头加
import importlib; importlib.reload(your_module) - 更稳妥的做法是把逻辑封装进函数，每次运行都调新函数，避免跨文件 import 后长期驻留内存
- 如果是插件开发（
__init__.py），启用/禁用插件一次就能强制重载全部模块 - 别在
if __name__ == "__main__":块里做复杂初始化——这个块只在“Run Script”时执行一次，后续调试无法复现
最常被忽略的一点：Blender 的 API 行为高度依赖当前上下文（active object、edit mode、scene collection）。同一行 bpy.ops.object.mode_set(mode='EDIT') 在物体模式下成功，在渲染预览窗口中直接抛异常。写脚本前，先用 Blender 手动操作一遍流程，再对照 API 文档翻译成代码，比硬猜可靠得多。
