vscode 默认不支持 toml 格式化与校验，需安装 taplo-vscode 插件并确保 taplo cli 可执行；格式化失效常见于未下载二进制、语言模式非 toml、设置中禁用 formatter 或 toml.validate 为 false；校验依赖 toml.validate=true、正确配置 toml.taplopath 及重载窗口。
VSCode 默认不支持 TOML 自动格式化或校验，必须装 taplo-vscode 插件 + CLI 工具才能启用这两项功能；只装 bierner.toml 或 Even Better TOML 只能高亮，不报错也不格式化。
为什么格式化快捷键（Shift+Alt+F）没反应
常见错误现象是按下后编辑器无响应，或状态栏提示“没有可用的格式化程序”。这不是快捷键冲突，而是 VSCode 没找到注册的 TOML 格式化提供者。
-
taplo-vscode插件会自动下载并启动 Taplo 语言服务器，但前提是它成功拉取了二进制 —— 首次打开 TOML 文件时可能卡在“Downloading taplo…”（尤其在国内网络环境下） - 若你手动安装过
taploCLI（比如用cargo install taplo-cli或choco install taplo），需确认taplo命令在终端中可执行，否则插件无法 fallback 到本地二进制 - 检查设置里是否被其他插件覆盖了
[toml]语言特定配置：打开settings.json，搜"[toml]"，确保里面没写"editor.defaultFormatter": ""或设为 null - 格式化只对语言模式为
toml的文件生效 —— 点击右下角状态栏确认显示的是toml，不是plaintext或ini
校验不标红？检查这三个配置项
TOML 语义错误（如重复 key、非法嵌套 table、未闭合字符串）不会靠语法高亮发现，必须启用 Taplo 的 LSP 校验能力。它依赖三个关键设置：
-
toml.validate必须设为true（不是"on"，是布尔值） -
toml.taploPath要填对 —— 如果用cargo install安装，macOS/Linux 通常是$HOME/.cargo/bin/taplo，Windows 是%USERPROFILE%\.cargo\bin\taplo.exe；如果用curl | sh安装，默认在/usr/local/bin/taplo -
editor.semanticHighlighting.enabled不影响校验，但若关了，错误提示的波浪线可能变淡，容易忽略；建议保持默认true
改完设置后，**必须重载窗口（Ctrl+Shift+P → “Developer: Reload Window”）**，仅重启插件不够。
格式化行为不符合预期？看 .taplo.toml 配置
Taplo 的格式化逻辑由工作区根目录下的 .taplo.toml 控制，不是 VSCode 设置。默认不读取任何配置，所以所有选项都走内置规则 —— 比如 reorder_keys = true 会让 key 按字母排序，这在 Cargo.toml 里常导致 [dependencies] 被挪到文件末尾。
- 想禁用重排，加一个最小配置：
[formatting] reorder_keys = false
-
align_entries = true会让等号对齐，但会破坏某些工具（如cargo add）生成的紧凑风格 - 如果项目含多个 TOML 文件（如
pyproject.toml+rustfmt.toml），可在include字段显式列出，避免误处理target/下的临时文件
注意：.taplo.toml 改动后无需重启 VSCode，Taplo 语言服务器会热重载，但已有打开的文件需手动触发一次格式化（Shift+Alt+F）才生效。
最易被忽略的一点：TOML 的“合法”不等于“语义正确”。taplo 能捕获 [[package]] 下写了 version = "0.1.0" 却漏掉 name 这类结构错误，但它不会告诉你 serde = "1.0" 是否和当前 Rust 版本兼容 —— 那得靠 cargo check。校验和构建是两层事，别混在一起期待。
