TOML 文件在 VSCode 中语法高亮异常等问题，需安装 bung87 的 TOML 扩展、手动关联文件类型、检查 settings.json 中的 [toml] 配置并禁用冲突扩展。
如果您在使用 VSCode 编辑 TOML 格式的配置文件时发现语法高亮异常、自动补全缺失或格式化失效，则可能是 TOML 语言支持未正确启用或扩展配置存在冲突。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 TOML 官方扩展
VSCode 默认不内置 TOML 语言支持，需通过扩展提供完整语法识别与编辑能力。启用该扩展后，VSCode 才能正确解析 .toml 文件结构并提供语义级功能。
1、点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 TOML Language Support。
3、在搜索结果中找到由 bung87 发布的扩展，确认其描述为“TOML language support for Visual Studio Code”。
4、点击“安装”按钮，安装完成后点击“重新加载”以激活扩展。
二、手动关联 .toml 文件类型
某些项目中 TOML 文件可能使用非标准后缀（如 .config、.cfg），或 VSCode 未能自动识别文件语言模式，此时需强制指定语言模式以启用语法支持。
1、打开任意一个 TOML 格式文件（无论后缀名是否为 .toml）。
2、按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS） 打开命令面板。
3、输入 Change Language Mode 并回车。
4、在弹出的语言列表中选择 TOML。
5、若需永久绑定某类后缀，点击右下角当前语言标识（如“Plain Text”），再选择“Configure File Association for '.xxx'”，输入对应后缀并选中 TOML。
三、检查 settings.json 中的语言配置
用户自定义设置可能覆盖默认语言行为，例如禁用格式化器或关闭验证器。直接编辑工作区或用户设置可恢复 TOML 相关功能。
1、按下 Cmd+,（macOS）或 Ctrl+,（Windows/Linux） 打开设置界面。
2、点击右上角“打开设置（JSON）”图标（花括号 {}）。
3、在 settings.json 中查找是否存在 "[toml]": { ... } 配置块。
4、若不存在，手动添加以下内容：
"[toml]": { "editor.formatOnSave": true, "editor.suggest.snippetsPreventQuickSuggestions": false }
5、保存文件后，重新打开一个 .toml 文件验证功能是否恢复。
四、禁用冲突扩展
部分通用配置文件处理扩展（如 INI Tools、YAML Support）可能劫持 .toml 文件的语言模式，导致 TOML 扩展无法接管编辑行为。
1、在扩展视图中搜索 INI，检查是否有已启用的 INI 相关扩展。
2、搜索 YAML，确认未启用会注册 .toml 关联的 YAML 扩展（如某些旧版 YAML 插件存在此问题）。
3、对疑似冲突的扩展逐个点击“禁用”。
4、每次禁用后重启 VSCode，打开 .toml 文件观察语法高亮与悬停提示是否恢复正常。
