构建系统不自动触发的根本原因是selector未匹配当前文件的语法作用域（scope），sublime只认source.python等精确scope，不看文件扩展名；需用ctrl+shift+p→inspect scope确认实际scope，再严格配置selector。

构建系统不自动触发？检查 selector 是否匹配语法作用域

很多人写好 Python3.sublime-build，保存在 Packages/User/ 下，Ctrl+B 却没反应——根本原因不是命令写错，而是 selector 没对上当前文件的语法作用域（scope）。Sublime 不看扩展名，只认 scope。

实操建议：

AI建筑知识问答

AI建筑知识问答是一款面向办公、学习与创作场景的 AI 工具。

下载

• 打开一个 .py 文件，按 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（macOS），输入 Inspect Scope 回车，看输出里是否含 source.python
• selector 字段必须写成 "source.python"，不能是 "python" 或 ".py"
• 多个语言共存时（如 Python + Jinja2 模板），scope 可能是 source.python meta.embedded.line.jinja2，此时用 "source.python" 仍可匹配，但更窄的 scope 需精确填写
• 想让构建系统对所有代码类文件生效，可用 "selector": "source"；加 "source | text" 则连纯文本也覆盖（慎用）

Windows 路径含空格导致 cmd 失效？必须双引号 + 双反斜杠

在 Windows 上，cmd 字段若写成 ["C:Program FilesPython311python.exe", "-u", "$file"]，Sublime 会直接报 Unable to find command python.exe——因为 JSON 解析时单反斜杠被当转义符，路径实际变成 C:ProgramFilesPython311python.exe，且空格导致命令截断。

实操建议：

• Windows 下务必用双反斜杠 + 全路径加英文双引号："cmd": ["C:\Program Files\Python311\python.exe", "-u", "$file"]
• 路径不确定？CMD 中运行 where python，复制真实路径；别依赖开始菜单快捷方式或别名
• macOS/Linux 用户别学 Windows 写法：["python3.11", "-u", "$file"] 即可，前提是 which python3.11 能查到（推荐写死路径，避免 virtualenv 切换失效）
• 加 -u 参数是关键：禁用 stdout 缓冲，否则 print("hello") 可能卡住不输出

为什么 .env 或 .tf 文件绑定构建系统后仍不触发？

这类文件默认语法是 Plain Text，scope 是 text.plain，哪怕你已用 extensions 把 .env 绑定到 ShellScript 语法，构建系统仍不会自动激活——因为 selector 还是 "source.python" 这种固定值，没覆盖新 scope。

实操建议：

• 先确认文件真实 scope：打开 .env，用 Inspect Scope 查看，常见的是 source.shell 或 source.yaml（取决于你装的语法包）
• 构建系统中 selector 必须与之匹配，例如："selector": "source.shell"
• 如果同一构建系统要支持多种文件类型，用空格分隔多个 scope："selector": "source.shell source.yaml source.hcl"
• 别指望 extensions 配置能间接影响构建系统——它只管高亮，不改 scope

项目级构建系统怎么覆盖全局设置？

当你在团队项目中需要专用命令（比如用 Poetry 运行、带特定环境变量），又不想改全局 Packages/User/ 下的构建文件，就得走项目配置。但直接往 .sublime-project 里扔 build_systems 数组还不够。

实操建议：

• 必须先通过 Project → Save Project As… 生成 .sublime-project 文件，否则配置不加载
• build_systems 是数组，每个元素是完整构建对象，字段和 .sublime-build 文件一致：name、cmd、selector、working_dir 都得有
• 项目构建系统优先级高于全局，但 selector 规则不变：仍需匹配当前文件 scope 才能自动激活
• 未保存的文件（Untitled）无法使用任何构建系统——$file 展开为空，这是硬限制，项目配置也绕不过

真正容易被忽略的是：scope 匹配发生在文件打开瞬间，而构建系统加载是静态的。改了语法绑定（比如给 .tf 加了 HCL 包），必须重启 Sublime 或至少关闭再重开该文件，否则旧 scope 仍残留。