必须安装 bierner.toml 插件并手动配置 taplo CLI 才能实现 TOML 语法高亮、格式化和语义校验，Even Better TOML 仅声明语言 ID 无实际功能。

VSCode 默认不识别 .toml 文件，装了插件却没高亮、按 Shift+Alt+F 没反应、状态栏右下角还是显示 “Plain Text”——这不是你操作错了，是 VSCode 根本没把文件当 TOML 解析，缺的是语言模式绑定 + 正确插件组合。

为什么 Even Better TOML 插件装了也白装

Even Better TOML 只声明语言 ID，不提供任何实际能力。它不带语法高亮逻辑，不注册格式化器，也不启动语言服务器。你装完发现 pyproject.toml 还是灰底黑字，是因为 VSCode 没有别的插件来接管 toml 语言模式。

• 打开任意 .toml 文件，右下角不显示 toml → 说明语言模式未激活，Even Better TOML 被完全忽略
• 按 Shift+Alt+F 无响应 → 它没实现 documentFormattingProvider，连基础格式化入口都没有
• 想看 Duplicate key 报错？它连校验器都不挂载，更别说调用 taplo

必须用 bierner.toml 才能开箱即用

bierner.toml 是目前唯一轻量、稳定、无需额外配置就能工作的 TOML 插件。它内置语法高亮、括号匹配、悬停提示，并通过封装 taplo CLI 提供基础格式化（非严格语义校验）。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 安装后重载窗口，打开 Cargo.toml 或 pyproject.toml，右下角立刻显示 toml
• Shift+Alt+F 生效，且默认支持 "[toml]": { "editor.formatOnSave": true }
• 若格式化失效，先禁用 Prettier 或 EditorConfig —— 它们常劫持快捷键和保存行为
• 不要同时启用 Even Better TOML 和 bierner.toml，二者冲突会导致语言模式反复切换

要真正校验语义，必须配 taplo CLI + taplo-vscode

bierner.toml 只做渲染，重复 key、非法嵌套、table 闭合错误等，全靠 taplo CLI 在后台解析。VSCode 不会自动下载它，你得手动装，否则所有结构类报错都不会出现。

• Linux/macOS：curl https://get.taplo.dev | sh；Windows：choco install taplo 或 cargo install taplo-cli
• 再装官方插件 taplo-vscode（不是旧名 taplo-language-server）
• 装完后检查设置：toml.validate 设为 on，toml.taploPath 填对二进制路径（如 /usr/local/bin/taplo）
• 项目根目录若有 .taplo.toml，校验规则以此为准；没有则走默认 spec

格式化行为不一致，空行和 table 排序容易踩坑

bierner.toml 内置格式化和 taplo format 输出结果不同。同一份 pyproject.toml，前者可能保留空行、后者强制压缩；前者不重排 [[tool.poetry.group.dev.dependencies]] 顺序，后者按字母排序。

• 团队协作时，必须统一用 taplo format 并禁用 bierner.toml 的格式化（设 "[toml]": { "editor.formatOnSave": false }）
• taplo 默认不加空行分隔不同 section，如需保持可配 .taplo.toml：format.empty_lines_between_tables = true
• 别指望 VSCode 自动修复 [[foo]] 后多写一个 [[foo]] —— 那属于语义错误，只有 taplo CLI 调用 LSP 才能标红

最常被跳过的一步：确认 taplo 二进制在 $PATH 里且权限可执行。VSCode 插件只调命令行，它不会帮你修环境变量或降权运行。