Sublime Text语法高亮依赖语法定义、配色方案与作用域协同实现，非独立开关；新建文件为Plain Text因未匹配扩展名或default_syntax配置错误，需确保路径正确、大小写敏感且重启生效。
Sublime Text 本身没有叫“语法解析功能”的独立开关，它靠语法定义（.sublime-syntax 或 .tmLanguage）+ 配色方案（.tmTheme）+ 作用域（scope）三者协同实现代码识别与高亮——所谓“解析”，其实是匹配规则的执行过程，不是编译器式的语义分析。
为什么新建文件还是 Plain Text？查 default_syntax 路径和版本兼容性
这个配置只对未保存、无路径、无扩展名的 untitled 文件生效，填错就静默失效：
-
default_syntax值必须是完整路径，且以.sublime-syntax结尾（Sublime Text 4+ 已弃用.tmLanguage） - 路径大小写敏感：写成
Packages/Python/python.sublime-syntax就不加载 - 别手敲路径——打开一个已高亮的
.py文件，按Ctrl+Shift+P→Show Scope Name，看到source.python，就转成Packages/Python/Python.sublime-syntax - 改完设置必须重启 Sublime Text，部分版本不重启不会重载语法绑定
文件打开后仍是 Plain Text？优先检查 file_extensions 绑定
Sublime 不会“猜”文件类型，只认扩展名或 shebang。对 .env、.log、.conf 这类文件，default_syntax 完全不起作用：
- 先打开一个
.env文件，右下角点 “Plain Text” → 选 “INI” → 再点右下角 →Open all with current extension as…→ 确认选 INI - 这会在
Packages/User/Preferences.sublime-settings中自动生成一段："extensions": ["env"], "syntax": "Packages/INI/INI.sublime-syntax" -
extensions列表里不能带点（写"env"，不是".env"），且值必须是字符串数组 - 如果手动编辑，注意 JSON 格式：多一个逗号、少一个引号，整个用户设置加载失败，Sublime 回退到内置默认值
自定义语言高亮不生效？验证 scope 和上下文顺序
写完 MyLang.sublime-syntax 后没高亮，90% 是规则没匹配上，而不是语法文件没加载：
- 文件必须放在
Packages/User/下（如Packages/User/mylang.sublime-syntax），不能嵌套子目录 -
scope必须以source.开头（如source.mylang），否则主题无法关联样式 -
contexts中的match规则按书写顺序执行：字符串引号规则若写在关键字规则前面，"if"就整段被当字符串吞掉，关键字永远不触发 - 按
Ctrl+Shift+P→Inspect Scope，把光标停在目标词上，看弹出的 scope 是不是你写的（比如keyword.control.mylang）；如果不是，说明没匹配 - 避免用
push:进入新 context 后忘记pop: true，否则后续所有文本都卡在错误 context 里
最常被忽略的一点：语法定义只是“告诉 Sublime 这段文本属于什么类型”，真正决定颜色的是配色方案（color_scheme）是否定义了对应 scope 的样式。如果你写了 mylang.string，但当前主题只定义了 string.quoted.double，那它就是纯白——不是语法错了，是主题没覆盖。
