VSCode无统一“清理文本格式错误”功能，需分清问题类型并配置对应工具：Trim Trailing Whitespace仅删行尾空白不删空行；Prettier默认不处理JSON/XML，需显式配置；EditorConfig仅定义编辑器行为，不格式化代码；正则替换仅适合救急，结构化清理应交由Prettier或ESLint。
VSCode 本身不提供“清理文本格式错误”的统一功能，所谓格式错误（比如混用空格/Tab、多余空行、行尾空格、缩进错位）其实是多个独立问题的集合。直接装个“格式清理插件”往往治标不治本，甚至引发新冲突——关键得先分清哪类问题、谁该负责、怎么配链路。
为什么“Trim Trailing Whitespace”不删空行
这是最常被误解的点：editor.action.trimTrailingWhitespace 命令只处理每行末尾的空白字符（空格、制表符），它不会触碰换行符本身，所以纯空行（\n\n）完全不受影响。
- 执行方式：按
Ctrl+Shift+P→ 输入Trim Trailing Whitespace回车 - 它对
JSON、XML、JavaScript等所有语言都生效，不依赖插件 - 若想连空行一起删，必须靠格式化器（如
Prettier或xmlTools）在Format Document阶段处理 - 注意：它不会改变字符串内、注释内或行首的空格，只动“行尾”
Prettier 对 JSON / XML / HTML 的支持边界在哪
Prettier 默认不处理 .json 和 .xml 文件，除非你显式配置；而对 .html 它能格式化结构但不校验语义。这不是缺陷，是设计取舍。
- JSON：需在
.vscode/settings.json中加"[json]": { "editor.defaultFormatter": "vscode.json-language-features" }，或禁用 Prettier 处理 JSON："prettier.disableLanguages": ["json"] - XML：Prettier 原生不支持，必须用
XML Tools插件，并在语言设置里启用："xml.format.enable": true - HTML：Prettier 支持，但
<script setup>或<style>区块不归它管；自闭合标签（<img />）和 Fragment（<></>）也不会被重命名同步 - 所有配置都依赖右下角语言模式正确识别——显示
Plain Text就等于没启动任何格式化器
EditorConfig 是怎么“兜底”的
EditorConfig 不格式化代码，它只告诉 VSCode “这个项目该用什么编辑器行为”，比如缩进用空格还是 Tab、宽度多少、换行符类型。它是跨编辑器一致性的唯一可靠手段。
- 必须放在项目根目录，文件名是
.editorconfig（注意开头的点） - 内容示例：
indent_style = space、indent_size = 2、end_of_line = lf - 它优先级高于用户级
settings.json，但低于语言特定设置（如[json]块） - 如果
.prettierrc里设了tabWidth: 4，而.editorconfig是indent_size = 2，保存时就会来回打架——两个值必须一致
正则替换能救急，但不能当主力
VSCode 搜索面板的正则（Ctrl+H）适合一次性清理脏数据，比如从日志粘贴过来的带前缀文本，但它没有上下文感知能力，容易误伤。
- 删所有连续空行（留一个）：查找
\n\s*\n，替换为\n\n；多跑一次确保收敛 - 删行首/行尾空白（含空行）：启用正则，查找
^\s+|\s+$，替换留空 - ⚠️ 危险操作：用
^\s*$\n直接删空行会破坏 Git diff，因为把空行变没了，而非“压缩” - 真正需要结构化清理（比如 JSX 属性换行、对象键排序），请交给
Prettier或ESLint，别硬刚正则
最易被忽略的是：格式化链路上任意一环断开（插件没装、路径没指定、语言模式错、配置项拼错），VSCode 都不会报错，只会静默跳过——你得手动验证 Format Document With 列表里有没有目标格式化器，否则永远在猜。
