Blender VSCode扩展完全使用指南

Blender VSCode扩展完全使用指南

【免费下载链接】blender_vscodeVisual Studio Code extension for Blender development.项目地址: https://gitcode.com/gh_mirrors/bl/blender_vscode

项目概述

Blender VSCode扩展是专为Blender开发者设计的强大工具，它让您能够在VSCode中轻松编写和调试Blender Python脚本。这个扩展将VSCode的专业编辑功能与Blender的脚本开发完美结合，大幅提升开发效率。扩展支持Blender 2.8.34及以上版本，为插件开发和脚本编写提供完整的开发环境。

快速入门指南

安装配置

1. 获取扩展： 在VSCode扩展市场中搜索"Blender Development"，点击安装即可开始使用。

2. 路径设置： 在VSCode设置中找到blender.executables选项，配置您的Blender可执行文件路径。

基本使用流程

1. 打开插件文件夹（每个工作区一个插件）
2. 按Ctrl+Shift+P→ 输入Blender: Start
3. 选择Blender可执行文件并等待会话启动
4. 编辑插件后使用Blender: Reload Addons重新加载，使用Blender: Run Script执行脚本

首次打开Blender可能需要较长时间，因为系统会自动设置依赖库。

插件开发详解

创建新插件

运行Blender: New Addon命令来搭建一个现成的插件文件夹。向导会询问使用哪个模板、在哪里保存插件（建议使用没有空格的空文件夹）、插件名称以及作者信息。

打开现有插件

此扩展适用于基于文件夹的插件或扩展。如果您的插件只是单个文件something.py，请将其移动到文件夹中并将文件重命名为__init__.py。

环境隔离

设置blender.environmentVariables将Blender指向专用的开发工作区：

"blender.environmentVariables": { "BLENDER_USER_RESOURCES": "${workspaceFolder}/blender_vscode_development" }

这可以将设置、插件和用户脚本与您的日常Blender设置分开。

脚本工具使用

脚本编写与执行

• 执行Blender: New Script并按照提示在您选择的文件夹中创建脚本
• 运行Blender: Run Script在任何通过VSCode启动的打开的Blender会话中执行每个脚本

脚本上下文控制

插入类似#context.area: VIEW_3D的注释或运行Blender: Set Script Context来控制脚本执行的位置。

自定义与快捷键配置

常用设置

扩展由设置驱动（在VSCode设置中搜索blender.）。一些有用的设置包括：

• blender.additionalArguments：传递额外的CLI标志和可选的默认.blend文件（建议将其作为最后一个参数）

• blender.executables：注册常用的Blender安装，并使用"isDefault": true标记一个以保持提示静默

键盘快捷键

在keybindings.json中添加条目来触发命令：

{ "key": "ctrl+h", "command": "blender.start" }

对于高级用法（选择特定的可执行文件或脚本）：

{ "key": "ctrl+h", "command": "blender.start", "args": { "blenderExecutable": { "path": "C:\\path\\blender.exe" }, "script": "C:\\path\\script.py" } }

故障排除与日志

常见问题解决

• 使用最新的VSCode和Blender版本
• 检查CHANGELOG.md以了解重大更改
• 在提交新问题之前先在GitHub上搜索问题

调试日志

通过blender.addon.logLevel启用调试日志，并在VSCode中检查Blender输出通道。

项目开发状态

该扩展不再处于活跃的功能开发阶段。欢迎提交错误报告；请尽可能详细地描述问题。如果您想提供帮助，请按照DEVELOPMENT.md中的说明开始。

通过合理利用这些资源和工具，您将能够更加专业地进行Blender脚本开发工作。

【免费下载链接】blender_vscodeVisual Studio Code extension for Blender development.项目地址: https://gitcode.com/gh_mirrors/bl/blender_vscode