Shift+Alt+F格式化后缩进错乱，是因为VSCode的Format Document仅做语义对齐，实际缩进由editor.insertSpaces/editor.tabSize、语言服务及Prettier等插件协同决定；根本原因是editor.detectIndentation误判开头几行导致全局缩进基准错误。
为什么 Shift+Alt+F 格式化后缩进反而错乱？
VSCode 的 Format Document 命令本身不决定用空格还是 Tab，也不决定缩进几格——它只做语义对齐。真正起作用的是三者叠加：当前生效的 editor.insertSpaces 和 editor.tabSize、语言服务识别出的文件类型、以及活跃的格式化插件（如 Prettier）的配置。
常见错误现象包括：Indentation not consistent 警告持续出现、保存后某几行突然多缩进 2 格、右下角显示 Spaces: 4 但代码里混着 →（Tab 字符）。
- 根本原因是
editor.detectIndentation默认为true，VSCode 只看开头几行（甚至一个空行或注释）就推断整份文件该用 Tab 还是空格、缩进多少，一旦开头混了格式，后续所有操作都基于这个错误前提 - 验证方法：临时禁用所有插件 → 只用
Shift+Alt+F→ 如果此时缩进正常，说明是 Prettier/ESLint 配置冲突；如果仍乱，问题在编辑器基础设置
如何用 .vscode/settings.json 一次性封死缩进混乱源头？
项目级配置优先级高于用户级，且能规避团队成员各自设置不一致的问题。关键不是加一堆选项，而是关掉自动探测、锁死两个核心参数，并与格式化工具对齐。
必须写入项目根目录 .vscode/settings.json（不是用户 settings.json）：
-
"editor.detectIndentation": false—— 关闭“猜缩进”，杜绝误判 -
"editor.insertSpaces": true—— 强制用空格（Python/JS/HTML 主流选择） -
"editor.tabSize": 2—— 统一缩进宽度（前端常用 2，Python 常用 4，按需改）
同时检查你的 .prettierrc 或 prettier.config.js 中 tabWidth 是否等于 editor.tabSize，useTabs 是否为 false。
粘贴后缩进崩了，怎么秒级拉回？
粘贴时缩进错乱，本质是源代码缩进风格和当前编辑器规则不匹配，而 editor.formatOnPaste 在中间强行“翻译”失败。手动调不如切断源头。
- 立刻修复：全选（
Ctrl+A）→Shift+Alt+F→ 然后点击右下角Spaces: 2→ 选Convert Indentation to Spaces（哪怕已经是 Spaces，这步能强制重写整文件缩进） - 长期解法：在工作区设置中加
"editor.formatOnPaste": false，避免格式化插件在粘贴瞬间重写缩进 - 开启
editor.renderWhitespace（设为"all"），让空格显示为小点、Tab 显示为→，一眼识别混用位置
XML/HTML 缩进不生效？确认格式化器是否真在干活
VSCode 默认不带 XML/HTML 格式化能力，你看到的行为几乎一定来自某个扩展。缩进设了没反应，大概率是格式化器根本没启用或被覆盖。
- XML：确认安装并启用
redhat.vscode-xml，然后Ctrl+Shift+P→ 输入Format Document With→ 选中它并设为默认；配置项是"xml.format.indentSize": 2（值必须是数字，不能是字符串） - HTML：确保
html.format.enable为true，且editor.autoIndent不是"none"；若装了 Prettier，需在settings.json中明确指定"html.format.enable": false并设 Prettier 为 HTML 默认格式化器 - 检查右下角语言模式：若显示
Plain Text而非HTML或XML，点击切换，否则所有格式化逻辑都不触发
最常被忽略的一点：改完配置后，未保存的文件不会立即响应新设置，必须先 Ctrl+S 再 Shift+Alt+F 才能触发格式化逻辑。
