构建系统不自动触发的根本原因是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。
实操建议：
- 打开一个
.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展开为空，这是硬限制，项目配置也绕不过
.tf 加了 HCL 包），必须重启 Sublime 或至少关闭再重开该文件，否则旧 scope 仍残留。 
