使用Visual Studio 2019调试Blender Python代码时断点无法触发问题求助

开发者阿泽

2026-9-29

可行解决步骤

先确认目标Python文件的实际加载路径
启动调试中的Blender，打开内置Python控制台，依次执行以下命令：
```
import 你要调试的目标模块名
print(你要调试的目标模块名.__file__)
```
输出的路径就是Blender实际加载的文件路径，你设置断点的文件必须和该路径完全一致，Windows下盘符大小写、斜杠方向的差异都会导致VS无法识别断点对应文件。
手动加载Python符号
调试器启动Blender后，依次点击VS顶部菜单「调试」→「窗口」→「模块」，在模块列表中找到Blender对应版本的Python dll（例如Blender3.1对应python310.dll），右键选择「加载符号」，符号路径指定为Blender源码依赖库下的Python目录、以及build目录下的Python符号文件夹即可。
手动指定附加调试的代码类型
不要直接从VS启动调试，先正常启动编译好的Blender，再回到VS点击「调试」→「附加到进程」，找到Blender进程后，点击「附加」按钮旁边的「选择」，手动勾选「Python 代码」和「本机代码」，确认后再附加进程，断点即可正常触发。
检查Blender构建配置项
如果你构建Blender时开启了WITH_INSTALL_PORTABLE配置项，确保Blender启动时优先读取build目录下的scripts文件夹内的脚本，而不是系统用户目录下的缓存脚本，避免路径不一致问题。
适配VS Python组件版本
确认你安装的VS2019「Python开发」工作负载支持Blender对应Python版本的调试组件，例如Blender3.1使用Python3.10，需确保VS Python组件支持Python3.10版本调试。