VSCode 编辑 TOML、YAML、JSON 配置文件需手动设置语言模式、安装专用扩展（如 Red Hat YAML、TOML Language Support、JSON Tools）、绑定文件关联、启用保存自动格式化并配置默认格式化工具、支持内联注释与代码折叠。
如果您在使用 VSCode 编辑 TOML、YAML 或 JSON 配置文件时遇到格式混乱、语法高亮失效或自动补全缺失等问题，可能是由于语言模式未正确识别或扩展配置不完整。以下是针对这三类配置文件的编辑优化方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、手动设置语言模式
VSCode 有时无法自动识别配置文件的语言类型，导致语法检查与缩进规则失效。手动指定语言模式可立即启用对应语法支持与高亮。
1、打开目标配置文件（如 config.toml、deploy.yaml 或 package.json）。
2、点击窗口右下角显示的语言标识（例如“Plain Text”）。
3、在弹出的搜索框中输入 TOML、YAML 或 JSON，然后选择对应项。
二、安装专用语言扩展
官方基础支持有限，需通过社区扩展增强校验、格式化与智能提示能力。每种格式推荐一个经验证稳定的核心扩展。
1、在 VSCode 左侧活动栏点击扩展图标（或按 Cmd+Shift+X）。
2、搜索并安装 Red Hat YAML（用于 YAML 文件）。
3、搜索并安装 TOML Language Support（由 bung87 提供，支持语法高亮与错误检测）。
4、搜索并安装 JSON Tools（提供 JSON 格式化、验证与键名提取功能）。
三、配置文件关联绑定
避免每次手动切换语言模式，可通过用户设置将特定文件后缀自动映射到对应语言模式。
1、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Configure File Associations...。
2、在弹出的 JSON 设置中，添加如下键值对：
"*.toml": "toml"
"*.yml": "yaml"
"*.yaml": "yaml"
"*.jsonc": "jsonc"
四、启用格式化与保存自动修复
确保配置文件符合标准结构，减少因缩进、逗号或引号引发的解析失败。VSCode 可在保存时自动执行格式化操作。
1、打开设置（Cmd+, ），搜索 format on save，勾选 Editor: Format On Save。
2、在设置中搜索 default formatter，为每种语言设置默认格式化工具：
"toml": "bung87.tokamak"
"json": "esbenp.prettier-vscode"
五、使用内联注释与折叠控制
TOML 和 YAML 支持注释，但 JSON 原生不支持；合理利用编辑器折叠与注释提示能提升可读性与维护效率。
1、在 TOML 文件中，使用 # 注释内容 添加行内说明。
2、在 YAML 文件中，使用 # 注释内容 并确保缩进与所属结构层级一致。
3、在 JSON 文件中，改用 JSONC 模式（通过语言模式切换或文件关联 *.jsonc），即可启用 // 行注释 与 /* 块注释 */。
4、将光标置于对象或数组起始行，按 Cmd+Shift+[ 折叠代码块，按 Cmd+Shift+] 展开。
