VSCode本身不报缩进错误，但空格与Tab混用会导致Python报IndentationError、YAML解析失败、Git整行diff及Prettier报错；需设editor.renderWhitespace: "all"使空格显示为·、Tab为→，并关闭editor.detectIndentation，配合.vscode/settings.json和.editorconfig统一规范。
VSCode 本身不报缩进错误，但空格和 Tab 混用会直接导致 Python 报 IndentationError、YAML 解析失败、Git 提交整行 diff、Prettier 报 Expected indentation of 2 spaces but found a tab —— 所以必须可视化并统一。
怎么让空格和制表符“显形”
核心就一个设置：editor.renderWhitespace。设为 all 后，空格显示为 ·，Tab 显示为 →，一眼就能看出混用位置。
操作路径：按 Ctrl+,（Windows/Linux）或 Cmd+,（macOS）→ 搜索 render whitespace → 选 all。快捷键是 Ctrl+Shift+8（macOS 是 Cmd+Shift+8），可随时开关。
注意：boundary 模式只在行首/行尾显示，容易漏掉缩进行内的混用，不推荐用于排查问题。
为什么右下角显示的 “Spaces: 4” 突然变成 “Tab Size: 2”
VSCode 会根据当前文件已有缩进自动探测（editor.detectIndentation: true 默认开启），一旦你打开一个 Tab 缩进的老文件，它就立刻切到 Tab 模式——哪怕你全局设了 4 空格。
这不是 bug，是设计行为，但极易引发混乱。解决办法只有两个：
- 关掉自动探测：
"editor.detectIndentation": false（写进工作区.vscode/settings.json） - 手动点击右下角缩进信息，选
Convert Indentation to Spaces统一当前文件
别依赖“它自己会判断”，尤其在 Python 或 YAML 项目里，自动探测经常把第一行带 Tab 的注释当成全文件缩进依据。
如何永久避免混用（工作区级配置）
在项目根目录建 .vscode/settings.json，写死关键三项：
{
"editor.insertSpaces": true,
"editor.tabSize": 4,
"editor.detectIndentation": false
}
这样无论谁打开这个项目，按 Tab 键插入的都是 4 个空格，不会偷偷塞 Tab 字符。
如果项目有语言差异（比如前端用 2 空格、Python 用 4），加语言专属块：
"[python]": {
"editor.tabSize": 4
},
"[javascript]": {
"editor.tabSize": 2
}
⚠️ 切记不要只改用户全局设置——团队协作时，别人没配，照样混用。
已混用的文件怎么安全修复
别用查找替换删 \t 或空格：可能误伤字符串内缩进、注释对齐、多行模板字符串里的空白。
正确做法是用 VSCode 内置命令：
- 全选代码（
Ctrl+A） - 右键 →
Convert Indentation to Spaces（或按Ctrl+Shift+P输入Change Indentation） - 批量处理？装
EditorConfig for VS Code扩展，配合根目录.editorconfig文件（内容含indent_style = space和indent_size = 4）
操作前务必 git commit -m "chore: save pre-indentation cleanup" —— 否则 Git diff 会把所有行都标为修改，掩盖真实逻辑变更。
真正难的不是“怎么调设置”，而是让所有人打开同一个项目时，看到的缩进行为完全一致。靠人提醒没用，靠文档也靠不住，唯一可靠的是 .vscode/settings.json + .editorconfig 双保险，且必须提交进仓库。
