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 环境差异失败。

星火文档问答

星火文档问答是基于讯飞星火大模型的AI文档和知识库问答助手。

下载

• 优先用 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，得手动把可执行文件路径塞进去。