VSCode中空格与Tab混用可通过启用“显示空白字符”快速识别，·代表空格、→代表Tab；统一缩进应配置工作区settings.json关闭自动探测并设为4空格，或使用.editorconfig跨编辑器统一规范。
VSCode 显示缩进错误：空格和 Tab 混用怎么快速识别
VSCode 本身不会报“缩进错误”，但当你打开 editor.renderWhitespace（或在设置里勾选「显示空白字符」），就能看到 · 表示空格、→ 表示 Tab。混用时，同一文件里出现两种符号，尤其在 Python 或 YAML 中会直接导致 IndentationError 或解析失败。
常见诱因：copy-paste 外部代码、多人协作未统一编辑器配置、从 IDE 导入项目时保留了原缩进习惯。
- 检查当前文件实际缩进：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Toggle Render Whitespace回车启用 - 查看右下角状态栏：那里会显示当前文件的缩进类型（如
Spaces: 4或Tab Size: 2），点击可切换 - 注意：状态栏显示的是「当前文件的编辑器设置」，不一定是工作区或用户全局设置
一键统一为 4 个空格（推荐 Python/JS/TS 通用方案）
多数现代项目约定用空格而非 Tab，且以 4 为单位。VSCode 支持基于语言自动应用缩进规则，关键在配置 "editor.insertSpaces" 和 "editor.tabSize"。
优先写入工作区设置（即项目根目录下的 .vscode/settings.json），避免污染全局：
{
"editor.insertSpaces": true,
"editor.tabSize": 4,
"editor.detectIndentation": false
}
-
"editor.detectIndentation": false是重点：关掉自动探测，否则打开旧文件时 VSCode 会按文件已有缩进覆盖你的设置 -
"editor.insertSpaces": true确保按Tab键时插入空格，不是真实 Tab 字符 - 如果只针对某语言（如 Python），可加语言专属配置：
"[python]": { "editor.tabSize": 4 }
已混用缩进的文件怎么安全修复
别手动删空格或替换 Tab——容易误伤字符串内缩进或注释对齐。用 VSCode 内置功能最稳：
- 全选代码（
Ctrl+A），右键 →Convert Indentation to Spaces（或to Tabs） - 快捷键更高效：选中后按
Ctrl+Shift+P，输入Change Indentation，选对应命令 - 若需批量处理多个文件，安装扩展
EditorConfig for VS Code，配合项目根目录的.editorconfig文件统一规范
注意：转换前务必提交 Git 快照，因为缩进变更会触发整行 diff，影响 code review 判断逻辑改动。
为什么 .editorconfig 比 settings.json 更可靠
.editorconfig 是跨编辑器标准，WebStorm、Sublime、Vim 都支持。VSCode 默认不启用它，需装扩展并确保 editorconfig.editorconfig 启用。
一个最小可用的 .editorconfig 示例：
root = true [*] indent_style = space indent_size = 4 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true [*.py] indent_size = 4 [*.yaml] indent_size = 2
-
root = true防止向上层目录查找，避免意外继承 - 不同后缀可差异化配置（如
.yaml习惯用 2 空格），比纯 VSCode 设置灵活 - 只要文件保存时触发格式化（如启用
editor.formatOnSave），就会按此规则自动对齐
真正麻烦的不是改一次缩进，而是让所有人、所有新文件、所有 CI 工具（如 pre-commit、eslint、black）都按同一套规则跑。.editorconfig 是目前最轻量也最不容易被绕过的锚点。
