Sublime Text 默认不支持 TOML 语法高亮,需通过 Package Control 安装官方推荐的 TOML 插件(作者 bsara),并手动将 .toml 后缀关联至 TOML 语法,避免被 INI 等插件劫持。

Sublime Text 没有默认 TOML 语法高亮
Sublime Text 原生不带 TOML 语法定义,打开 .toml 文件时默认是纯文本,关键词、字符串、注释全无颜色区分。这不是你配置错了,是它本来就不支持。
安装 Package Control 后装 TOML 插件最稳
别手动复制语法文件——容易路径错、版本旧、更新难。直接用 Package Control 装社区维护的插件:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Install Package回车 - 搜
TOML,选TOML(作者:bsara,GitHub 星标高、持续更新) - 装完重启 Sublime 或直接新建
test.toml文件测试
注意:别装叫 TOML Language 或 toml-syntax 的冷门包,它们可能不维护、不识别 [tool.poetry] 这类嵌套表头。
手动关联 .toml 后缀到 TOML 语法(如果没自动生效)
装完插件后,有时新文件仍显示为 Plain Text。这是因为 Sublime 没把 .toml 后缀和语法绑定:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 打开任意
.toml文件 - 点击右下角当前语法名(比如
Plain Text)→ 选TOML - 再点一次 → 选
Open all with current extension as…→ 再选TOML
这步会写入 Preferences.sublime-settings 的 extensions 映射,之后所有 .toml 文件都自动高亮。
高亮失效?检查是否被其他插件劫持了语法
有些插件(比如 INI、EditorConfig、甚至某些 LSP 客户端)会强行把 .toml 当作 INI 处理,导致注释符号 # 不变色、数组语法 [[dependencies]] 无法折叠。
- 关掉疑似插件,重启 Sublime,看高亮是否恢复
- 在命令面板运行
Set Syntax: TOML,确认当前语法确实是TOML而非INI - 检查
View → Syntax → Open all with current extension as…是否指向了INI
TOML 的方括号层级、内联表、多行字符串这些特性,只有专用语法定义才能正确解析;凑合用 INI 高亮,迟早漏掉 '''multiline''' 或误判 [group.sub] 的嵌套关系。

















