sublime text 默认不识别 .toml 文件,右下角显示 plain text 是正常现象——因自带语法列表不含 toml,需安装官方维护的 toml 插件(如 sublimelsp 或 braver 版),安装后必须重启才能注册 source.toml 语法并显示 toml 选项,否则高亮、lsp 等均不生效。

Sublime Text 默认不识别 .toml 文件,右下角显示 Plain Text 是正常现象——不是编辑器坏了,是语法包没装或没绑定。
为什么 .toml 文件打开就是白底黑字?
Sublime Text 自带语法列表里没有 TOML,它不会自动把 .toml 当作配置文件处理。哪怕你刚用 cargo new 初始化一个 Rust 项目,Cargo.toml 打开后仍是无高亮的纯文本。
- 右下角状态栏显示
Plain Text→ 表示当前未激活任何 TOML 语法定义 - 手动点击右下角选
TOML→ 若菜单里压根没有这一项,说明插件未安装或加载失败 - 装了插件但点不了
TOML→ 常见于插件安装后没重启 Sublime,或 Package Control 初始化异常
必须装 TOML 插件,且推荐用 TOML 官方维护版
别搜“TOML syntax”乱装,优先选 GitHub 上 star 最多、更新最勤的 TOML 插件(非 TomlSyntax 或旧版 sublime-toml)。它支持现代 TOML v1.0+ 规范,包括 inline table、array of tables、datetime 字面量等高亮。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 打开命令面板:
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS) - 输入
Package Control: Install Package,回车 - 搜索
TOML,选择作者为sublimelsp或braver的那个(2026 年主流版本) - 安装完成后,**必须重启 Sublime Text** —— 否则
.sublime-syntax文件不注册,右下角仍无TOML选项
后缀绑定和 scope 必须对得上,否则 LSP 或补全不触发
只装插件还不够。如果后续要配 LSP 支持(比如配合 rust-analyzer 读取 Cargo.toml),就必须确认语法 scope 是 source.toml,且文件后缀已绑定到该语法。
- 新建一个空文件,保存为
test.toml,右下角应显示TOML;若仍为Plain Text,说明绑定失败 - 检查插件是否正确注册:按
Ctrl+Alt+Shift+P(Win/Linux)或Cmd+Opt+Shift+P(macOS),看输出是否含source.toml - 若显示
source.toml但高亮不对(如字符串不红、注释不灰),大概率是当前 color scheme 没定义string.quoted.double.toml等 scope —— 换用Monokai或Adaptive主题可快速验证 - 手动绑定后缀(备用):Preferences → Settings – Syntax Specific,粘贴:
{"extensions": ["toml"]},保存后该文件类型即强制走 TOML 语法
常见失效组合:PATH 正确 ≠ LSP 能读到 TOML
很多人配完 rust-analyzer 发现 Cargo.toml 里依赖项标红、跳转不到 crate 文档——问题不在 Rust 工具链,而在 Sublime 没把 .toml 当作有效源码。
-
rust-analyzer配置中"syntaxes"必须包含"Packages/TOML/TOML.sublime-syntax"(注意大小写和路径斜杠方向) - 若插件安装后路径是
Packages/User/TOML/,需改用该路径,否则 LSP 启动时找不到语法定义,直接静默跳过 - 终端里
rust-analyzer --version成功 ≠ Sublime 能调用它;Sublime 不继承 shell PATH,尤其 macOS 从 Dock 启动时 PATH 极简,"command"必须写死绝对路径 - 验证是否真生效:打开
Cargo.toml,右下角状态栏应同时显示TOML和LSP: ready;缺一不可
真正卡住人的往往不是“怎么装”,而是“装完没反应”时不知道该查哪一层:是 Package Control 没活过来,还是语法没注册,或是 scope 名写错了一个字母。点一下右下角,再按一次 Ctrl+Alt+Shift+P,比重装十次都管用。










