必须先安装Package Control才能安装TOML插件;安装后需在Package Control中搜索并安装tamasfeher开发的Toml插件;若.toml文件仍显示Plain Text,须手动绑定语言或修改用户设置中的default_extension。

Sublime 安装 TOML 插件前必须先装 Package Control
没装 Package Control,就等于没打开 Sublime 的插件生态入口——所有 TOML 插件都依赖它安装。控制台命令执行失败是常见卡点,尤其在有代理、防火墙或输入法热键冲突(比如 QQ 拼音占用了 Ctrl+`)的环境里。
先用 View → Show Console 或手动解除输入法热键后按 Ctrl+` 调出控制台,粘贴带校验的安装代码(Sublime Text 3 稳定版推荐用法):
import urllib.request,os,hashlib; h ='6f4c264a24d933ce70df5dedcf1dcaee'+'ebe013ee18cced0ef93d5f746d80ef60'; pf ='Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen('http://packagecontrol.io/'+ pf.replace(' ','%20')).read(); dh = hashlib.sha256(by).hexdigest();print('Error validating download (got %s instead of %s), please try manual install'% (dh, h))if dh != h else open(os.path.join( ipp, pf),'wb').write(by)
执行后若无报错且 Preferences → Package Settings 下出现 Package Control 项,说明成功;否则需手动下载 Package Control.sublime-package 放入 Installed Packages/ 目录。
搜 “Toml” 别选错名字:认准作者 tamasfeher 的 Toml 插件
Package Control 里搜 TOML 会出现多个结果,真正能识别 .toml 文件并提供完整语法高亮的是 Toml(作者:tamasfeher),不是 AdvancedToml 或 toml-syntax——后者部分已停止维护,对嵌套表、点分键等 TOML v1.0 特性支持不全。
立即学习“Python免费学习笔记(深入)”;
- 按
Ctrl+Shift+P打开命令面板,输入Install Package回车 - 等待列表加载完成,输入
Toml(注意大小写和拼写),选中后回车 - 安装完不用重启,直接新建一个
test.toml文件,看是否自动启用高亮;如果还是白色文本,说明插件未生效
.toml 文件右下角显示 Plain Text?手动绑定语言才是关键
即使插件装好了,Sublime 也可能因为缓存或配置缺失,继续把 .toml 当作纯文本处理。这不是插件问题,而是语言绑定没走通。
- 打开任意一个
.toml文件,右下角状态栏点击当前语言名(如Plain Text) - 选择
Open all with current extension as… → Toml - 更彻底的做法:进 Preferences → Settings,在右侧用户设置里加这行(截至 2026 年 3 月 25 日仍有效):
"default_extension": "Packages/Toml/Toml.sublime-syntax"(注意路径大小写)
Rust/Python 项目里 TOML 高亮常被忽略的联动点
TOML 高亮在 Rust/Python 项目里不是孤立功能——它和构建系统、LSP 启动强相关。比如 Cargo.toml 或 pyproject.toml 若没正确高亮,往往意味着 Sublime 没识别为 TOML 文件,进而影响 LSP 插件对 workspace 的初始化判断。
- Rust 项目中,
Cargo.toml不高亮 →LSP: rust-analyzer状态栏图标可能不亮,即使rust-analyzer二进制路径全对 - Python 项目中,
pyproject.toml显示为Plain Text→SublimeCodeIntel或python-lsp-server可能跳过该文件解析 - 验证方法:打开
Cargo.toml,右下角必须显示Toml(不是Plain Text或JSON),再检查状态栏是否有LSP: rust-analyzer
真正卡住人的从来不是插件装不装得上,而是语言识别这一层没打通——状态栏那个小字,决定了后续所有能力能不能激活。


















