DCC Python (Visual Studio Code)

A universal Python development tool designed to support all DCC applications with Python scripting capabilities.

一个通用的 Python 开发工具，旨在支持所有具备 Python 脚本能力的 DCC 软件。

本项目开发参考了开源仓库 vscode-maya-python，在此由衷感谢作者 @nils-soderman 的开源分享与贡献。

This project refers to the open-source repository vscode-maya-python. Special thanks to @nils-soderman for his open-source work and contributions.

Currently tested with / 目前经过测试的 DCC：

• Maya
• 3ds Max
• Substance Painter

Other DCC applications will be supported gradually / 其他 DCC 将逐步支持。

Requirement / 要求: All features require Python 3.7+ in the DCC environment. The codebase uses modern Python 3 syntax (f-strings, type annotations, etc.) and debugpy requires Python 3.7+. DCC applications running Python below this version will encounter errors.

所有功能需要 DCC 环境中 Python 版本 ≥ 3.7。代码库使用现代 Python 3 语法（f-string、类型注解等），且 debugpy 需要 Python 3.7+。运行低于此版本 Python 的 DCC 软件将报错。

Features / 功能

Execute Code / 执行代码

Run code in your DCC directly from within the editor:

在 VS Code 中直接执行代码并发送到 DCC 软件：

Maya:

3ds Max:

Substance Painter:

Command / 命令: DCC Python: Execute Keyboard Shortcut / 快捷键: Ctrl + Enter

The selected text will be executed. If nothing is selected, the entire document will be executed.

执行选中的代码片段；若未选中任何内容，则执行整个文档。

Attach Debugger / 附加调试器

Attach VS Code to your DCC to debug scripts, set breakpoints and step through code.

将 VS Code 附加到 DCC 软件，支持设置断点、单步调试代码。

Maya:

3ds Max:

Substance Painter:

Command / 命令: DCC Python: Attach Debugger

When the debugger is attached, press Ctrl + Enter to execute code — breakpoints will be hit automatically. print() output is redirected to the VS Code Debug Console.

调试器附加后，按 Ctrl + Enter 执行代码将自动触发断点。print() 输出会重定向到 VS Code 的调试控制台。

Reload Modules / 重载模块

Reload Python modules from your workspace without restarting the DCC application. Useful for iterative development.

无需重启 DCC 软件即可重载工作区中的 Python 模块，方便迭代开发。

Command / 命令: DCC Python: Reload Modules

Execute Entry Point / 执行入口点

Execute a predefined entry point script with a single command. Useful for running a project's main.py or a scene setup script.

一键执行预定义的入口点脚本，适用于运行项目的 main.py 或场景初始化脚本。

Command / 命令: DCC Python: Execute Entry Point

Configuration / 配置项:

Getting Started / 快速开始

1. Install the Extension / 安装扩展

Install the "DCC Python" extension from the VS Code Marketplace.

从 VS Code 应用商店安装 "DCC Python" 扩展。

2. Start the Server in Your DCC / 在 DCC 中启动服务端

Press Ctrl + Enter in VS Code — an error prompt will appear in the bottom-right corner. Click the "Copy" button, then paste and run the code in your DCC's script editor.

在 VS Code 中按 Ctrl + Enter，右下角会弹出提示框，点击"Copy"按钮，然后粘贴到 DCC 的脚本编辑器中运行即可。

3. Execute Code / 执行代码

Open a Python file in VS Code, press Ctrl + Enter to send the code to your DCC.

在 VS Code 中打开 Python 文件，按 Ctrl + Enter 将代码发送到 DCC 执行。

Configuration / 配置

All settings can be found in VS Code Settings under "DCC Python".

所有配置项可在 VS Code 设置中搜索 "DCC Python" 找到。

Server / 服务端

Execute / 执行

Debugger / 调试器

Environment / 环境

Supported DCC Applications / 支持的 DCC 软件

Python Requirement / Python 版本要求: All features require Python 3.7+ in the DCC environment. The codebase uses modern Python 3 syntax (f-strings, type annotations, etc.) and debugpy requires Python 3.7+. DCC applications running Python below this version will encounter errors.

所有功能需要 DCC 环境中 Python 版本 ≥ 3.7。代码库使用现代 Python 3 语法（f-string、类型注解等），且 debugpy 需要 Python 3.7+。运行低于此版本 Python 的 DCC 软件将报错。

Commands / 命令

All commands can be accessed via the Command Palette (Ctrl + Shift + P).

所有命令可通过命令面板（Ctrl + Shift + P）访问。

Contact / 联系方式

If you have any questions, suggestions, or encounter issues, please feel free to open an issue.

如有任何问题、建议或遇到 Bug，请提交 Issue。