Blender Debuger for VSCode 教程
1. 项目目录结构及介绍
该项目的主要目录结构如下:
gitignore
:.gitignore
文件,定义了在版本控制中忽略的文件和目录。Example.png
:示例图片,可能用于说明或教程中的视觉辅助。ISSUE_TEMPLATE.md
:GitHub 的问题报告模板。LICENSE.txt
:项目的许可证文件,这里是 GPL-3.0 许可证。README.md
:项目简介和安装指南。__init__.py
:Python 包初始化文件。test pytest.py
:测试脚本,用于验证代码功能。
除此之外,还有隐藏的 .vscode
目录,用于存储 Visual Studio Code 的工作区设置。
2. 启动文件介绍
该项目的核心部分是 Blender 插件和远程调试配置,它们允许通过 VSCode 调试 Blender 中的 Python 脚本。虽然没有明确的单个“启动”文件,但通常涉及以下步骤来开始调试:
- 在 Blender 中启用调试服务器(
[Blender Icon] / 系统 / 开始调试服务器
)。 - 在 VSCode 中打开包含你的 Blender 添加项的文件夹。
- 创建并配置一个远程调试会话,主机名设为
localhost
,端口号通常是5678
(根据 Blender 插件设置可能有所不同)。
3. 项目的配置文件介绍
.vscode/settings.json
(可能存在于用户或工作区间):VSCode 的个性化设置,例如排除特定文件或文件夹。.vscode/launch.json
:VSCode 的调试配置文件,这里可以定义调试器连接参数(如主机和端口),以及附加的调试选项。
为了调试 Blender 添加项,你需要在 launch.json
文件中创建一个远程调试配置,其属性包括要连接的主机和端口。例如:
{
"name": "Blender Remote Debug",
"type": "python",
"request": "attach",
"connect": {
"host": "localhost",
"port": 5678
},
"pathMappings": {
"<your_addon_path>": "<local_filesystem_path>"
}
}
<your_addon_path>
是你在 Blender 中添加项的路径, <local_filesystem_path>
是你在本地文件系统上的对应路径。这确保了 VSCode 可以正确映射到源代码进行调试。
请记得,这个教程是基于提供的仓库信息总结的,具体实现可能需要依据实际的项目文件和你的开发环境进行微调。