Sublime Text 支持多个构建系统，需将 .sublime-build 文件置于 User 包目录下，通过 name 字段定义菜单名，用 shell_cmd 和 env 显式指定路径与环境变量，避免依赖 shell 初始化。
怎么在 Sublime Text 里加多个构建系统
Sublime Text 默认只认一个 sublime-build 文件，想同时支持 Python、Go、TypeScript 等不同语言或不同环境（比如 dev vs prod），就得手动建多个构建定义文件，放在正确位置，再通过命令面板切换。
关键不是“怎么写”，而是“放哪”和“怎么触发”。很多人卡在文件没生效，其实是路径或命名不对。
- 所有构建系统文件必须放在
~/Library/Application Support/Sublime Text/Packages/User/（macOS）或%APPDATA%\Sublime Text\Packages\User\（Windows）或~/.config/sublime-text/Packages/User/（Linux） - 文件名必须以
.sublime-build结尾，比如Python-venv.sublime-build、Go-build.sublime-build - 文件内容里
name字段决定你在Tools → Build System菜单里看到的名称，不能重复 - 改完文件后不用重启 Sublime，但要确保当前打开的文件有对应
file_extensions，否则菜单里不显示该构建项
构建系统里 cmd 怎么写才跨平台
Windows 用 cmd.exe，macOS/Linux 用 sh，但 Sublime 的 cmd 字段默认不自动适配。硬写 python main.py 在 Windows 上可能找不到 python，在 macOS 上可能因 shell 环境差异失败。
- 优先用
shell_cmd替代cmd：它直接走系统 shell，能解析$PATH和环境变量 - 路径别写死，用
$file、$file_path、$file_base_name这类变量（Sublime 内置，大小写敏感） - 如果真要分平台，用
osx/windows/linux键做条件块，但多数情况没必要——shell_cmd+ 正确的 PATH 更可靠 - 示例：
"shell_cmd": "python \"$file\""，双引号包裹$file防空格路径出错
为什么选了构建系统却还是跑默认 Python
常见现象：你新建了 Python-poetry.sublime-build，也手动选中了它，但 Ctrl+B 一按，还是跑系统 Python，不是 poetry 环境里的。
- 根本原因：Sublime 启动时读取的是父进程的环境变量，不是你终端里
source过的那些。poetry 激活的PYTHONPATH、PATH它压根不知道 - 解决方法不是改
cmd，而是加env字段，显式注入环境："env": { "PATH": "/Users/you/.local/bin:/opt/homebrew/bin:$PATH", "PYTHONPATH": "/Users/you/.cache/pypoetry/virtualenvs/myproject-py3.11/lib/python3.11/site-packages" } - 更稳妥的做法是绕过环境变量，直接调用完整路径：
"shell_cmd": "/Users/you/.local/bin/poetry run python \"$file\"" - 注意：Windows 上路径用反斜杠要双写，或者统一用正斜杠（Sublime 支持）
构建输出中文乱码或卡住怎么办
尤其在 Windows 上跑 Python 脚本，控制台输出中文变成 ，或者构建过程卡住不动，大概率是编码或 stdin/stdout 配置问题。
- 加
"encoding": "UTF-8"是基础，但不够；Windows cmd 默认是 GBK，得让子进程也用 UTF-8："shell_cmd": "chcp 65001 >nul && python \"$file\"" - 如果脚本需要交互输入，Sublime 构建系统默认不提供
stdin，会卡住。这时必须用target指向插件（比如exec插件的变体），原生构建系统不支持交互 - 输出太长被截断？加
"quiet": false和"word_wrap": true到构建配置里，让面板显示更友好 - 调试技巧：先在终端里完整敲一遍
shell_cmd对应的命令，确认能跑通、编码正常，再搬进构建文件
最麻烦的永远不是写配置，而是环境隔离和路径解析——尤其当项目用了 pyenv、nvm、asdf 这类版本管理器时，Sublime 不会自动加载 shell 的 profile，得手动把可执行文件路径塞进去。
