点击右下角“Plain Text”可手动绑定文件后缀与语法,操作后自动写入Preferences.sublime-settings的extensions字段,路径须严格匹配且仅支持.sublime-syntax格式。

点击右下角“Plain Text”就能永久绑定新后缀
Sublime Text 不会自动识别任何新后缀,显示 Plain Text 是正常状态,不是故障。只要文件已打开,鼠标左键单击右下角的语法名(比如 Plain Text),在弹出菜单里选中目标语法(如 JavaScript、YAML),就会弹出确认框 “Set as Default for .xxx Files”,点确认即可。
这个操作会直接往 Packages/User/Preferences.sublime-settings 的 extensions 字段里加一条映射,例如:
{"extensions": {"myconf": "Packages/INI/INI.sublime-syntax"}}注意:myconf 是不带点的后缀名,值必须是完整路径;大小写和空格必须严格匹配;该配置对所有同后缀文件立即生效,无需重启。
.env、.toml、.log 这类小众后缀要先“认对语法”,再设配色或缩进
很多用户改了 color_scheme 或 tab_size 没反应,根本原因是文件压根没被识别为对应语法——.env 默认常被当成 Shell-Unix-Generic,而它不支持 KEY=VALUE 的等号高亮;.toml 若没手动绑定,就永远是 Plain Text,语法专属设置完全不加载。
正确顺序是:
- 打开一个
.env文件 → 点右下角Plain Text→Open all with current extension as…→ 选INI(内容形如DB_HOST=localhost)或ShellScript(含#!/bin/bash) - 再打开该文件 →
Preferences → Settings – Syntax Specific→ 填入{"color_scheme": "Packages/.../Dracula.sublime-color-scheme"} - 已打开的文件需关闭重开,或执行
Ctrl+Shift+P→Reload Syntax Definitions才能刷新作用域
手写 extensions 映射时,路径错一个字符就失效
不能靠猜路径,也不能复制网上过时的 .tmLanguage 格式。ST4 只认 .sublime-syntax,且路径必须以 Packages/ 开头,中间不能有错别字、多余空格或大小写偏差。
最稳的抄法:
- 新建一个
.py文件 →View → Syntax → Python - 再按
Ctrl+Shift+P→ 输入Set Syntax: Detect Syntax,确保右下角显示Python - 此时右下角会显示类似
Packages/Python/Python.sublime-syntax的完整路径,复制它 - 粘贴进
Preferences.sublime-settings的extensions项里,格式如:"py": "Packages/Python/Python.sublime-syntax"
写错会导致新建或打开对应后缀文件时回退到 Plain Text,但不会报错,极难排查。
自定义语法文件(.sublime-syntax)必须放对位置、起对名
想给 .cfg 或 .schema 写专用高亮?别手写 YAML,用 Tools → Developer → New Syntax 创建模板,然后只改三处:
-
name:状态栏显示名,如MyConfig -
scope:必须以source.开头,如source.myconfig -
file_extensions:YAML 列表格式,如- cfg、- schema(前面是短横线+空格,不是引号)
保存路径只能是 Packages/User/ 下,文件名必须是 xxx.sublime-syntax(结尾不能多 .bak,不能少 .sublime-)。Windows 和 macOS 路径不同,但 Sublime 只扫描 User 目录,其他位置一概无视。


















