项目配置不能覆盖语法识别逻辑，语法高亮由文件扩展名→用户extensions映射→文件内容→默认fallback决定；缩进等设置需通过语法专属配置而非项目配置实现。
项目配置不能覆盖语法识别逻辑
项目级设置（.sublime-project）能改缩进、构建系统、文件排除，但**不能改变文件用什么语法高亮**。比如你在项目里写"syntax": "Packages/TypeScript/TypeScript.sublime-syntax"，Sublime 会直接忽略——这个字段只在用户级 Preferences.sublime-settings 或语法专属设置中有效。
常见错误是把项目配置当成“万能开关”，结果改了 settings 字段却看不到语法变化。真正决定语法的是：文件扩展名 → 用户 extensions 映射 → 文件内容（shebang / magic string）→ 默认 fallback（Plain Text）。
让项目内特定后缀走指定语法：靠用户级 extensions 绑定
想让当前项目所有 .api 文件都用 OpenAPI 高亮，不是在 .sublime-project 里写，而是通过用户设置绑定扩展名与语法路径：
- 先打开一个
test.api文件，右下角若显示 Plain Text，手动点它 → 选 OpenAPI（需已安装对应插件） - 再点一次右下角 → 选 Set as Default for .api Files，Sublime 自动往
Packages/User/Preferences.sublime-settings写入：{"extensions": ["api"], "syntax": "Packages/OpenAPI/OpenAPI.sublime-syntax"} - 路径必须准确：用
Ctrl+Shift+P→PackageResourceViewer: Open Resource找到 OpenAPI 包，确认后缀是.sublime-syntax（ST4）而非.tmLanguage
这个绑定对所有项目生效。如果只想某项目生效，目前 Sublime 没原生支持；只能靠插件如 ApplySyntax + 自定义规则实现，但稳定性差、调试成本高。
项目内不同文件类型用不同缩进：语法专属设置优先于项目设置
项目配置里的 tab_size 只影响未识别语法的文件（如无后缀或 Plain Text）。真要让 .js 用 2 空格、.py 用 4 空格，必须走语法专属路径：
- 打开一个
.js文件，确认右下角显示 JavaScript（不是 Plain Text 或 JSON） -
Preferences → Settings – Syntax Specific→ 在打开的JavaScript.sublime-settings中写：{"tab_size": 2, "translate_tabs_to_spaces": true, "detect_indentation": false} - 同理，对
.py文件操作一次，生成Python.sublime-settings，填"tab_size": 4
这些文件存在 Packages/User/ 下，对所有项目生效。项目配置无法覆盖它们——因为语法专属设置的优先级高于项目设置。
为什么改了还是没高亮？先查作用域，别急着改配置
90% 的“语法不生效”问题，根源不是配置错，而是 Sublime 根本没识别出你想要的语法。验证方式只有一个：Ctrl+Shift+P → 输入 Show Scope Name → 看状态栏第一项，例如 source.python 或 text.plain。
如果显示 text.plain，说明：
- 文件有 shebang（如
#!/bin/bash）被识别为 ShellScript - 你之前手动点过右下角锁定过语法（Sublime 会记住单个视图的选择）
- 装了
AutoSetSyntax类插件，它在加载时强行重置了语法 -
Preferences.sublime-settings里extensions对应的syntax路径拼错，比如大小写不对、漏了Packages/、混用了.tmLanguage
作用域名大小写敏感、带点、带前缀，少一个字符就失效。别猜，Show Scope Name 是唯一可信依据。
