语法设置仅对右下角显示的已识别语法生效，需手动绑定扩展名与语法（如 .env→shellscript），路径须严格匹配st4的.sublime-syntax格式，且扩展名映射独立于语法包定义。
语法设置只对已识别的文件生效
Sublime Text 的语法专属配置（Preferences → Settings – Syntax Specific）不会自动触发，它依赖右下角状态栏显示的语法名。如果显示的是 Plain Text，菜单项会灰色不可点，配置文件也根本不会加载。常见诱因包括：文件无扩展名、后缀未绑定语法（如 .env）、shebang 干扰识别、或插件覆盖了默认语法定义。
解决方法很直接：
- 打开目标文件（比如
config.env） - 点击右下角当前语法名 → 选
Open all with current extension as…→ 手动指定ShellScript - 再点一次右下角 → 选
Set as Default for .env Files，这会自动写入Packages/User/Extensions.sublime-settings - 确认右下角变成
ShellScript后，再打开Preferences → Settings – Syntax Specific才能编辑ShellScript.sublime-settings
语法路径必须严格匹配版本和格式
如果你手动在 default_syntax 或插件配置里写语法路径，.sublime-syntax 和 .tmLanguage 绝对不能混用。ST4（2026年主流版本）只认 .sublime-syntax，写成 Packages/Python/Python.tmLanguage 会静默失效——界面不报错，但新建 untitled 文件依然显示 Plain Text。
查准路径最稳的方式是：
- 先打开一个正确高亮的
.py文件 - 按
Ctrl+Shift+P输入Show Scope Name，状态栏显示类似source.python - 对应语法路径基本就是
Packages/Python/Python.sublime-syntax（注意大小写） - 修改后必须重启 Sublime 或新建窗口才生效；改完没反应，大概率是 JSON 格式非法或路径拼错
扩展名绑定和语法包是两套独立机制
很多人误以为改语法包里的 file_extensions 字段就能让 .ts 文件高亮，其实不行。Sublime 的扩展名映射走的是用户级 Preferences.sublime-settings 中的 extensions 字段，和语法包内部定义无关。
推荐操作流程：
- 打开一个
test.ts文件 - 右下角点语法名 → 选
TypeScript（确保识别成功） - 再点一次右下角 → 选
Set as Default for .ts Files - 它会自动往
Packages/User/Preferences.sublime-settings写入："extensions": ["ts", "tsx"]，并关联到对应syntax路径 - 手动编辑时注意：
extensions是字符串数组，每个元素不含点号，末尾不能多逗号
冷门后缀需显式绑定，且大小写敏感
像 .vue 和 .Vue 在 macOS/Linux 下被视为不同后缀，Windows 虽不区分大小写，但路径中语法名仍需大小写准确。如果你配好了 VueComponent.sublime-settings，但 .vue 文件没生效，八成是绑定时选错了语法名（比如选成 Vue 而不是 VueComponent）。
验证方式简单粗暴：
- 打开任意
.vue文件 - 按
Ctrl+Shift+P输入Set Syntax Specific Setting→ 回车 → 从列表里选你期望的语法名（如VueComponent） - 立刻生效，无需重启，比菜单更可靠
- 如果列表里没有，说明该语法包没正确安装或路径未被识别
.txt 文件，只要没手动切换语法，Python.sublime-settings 就永远不会加载。
