不是格式化功能失效，而是VSCode缩进行为受editor.detectIndentation误判、Prettier tabWidth与editor.tabSize不一致、语言模式识别错误三重影响；应关闭detectIndentation、统一insertSpaces和tabSize，并确保语言模式正确及插件配置对齐。
能自动统一，但必须靠配置组合，单靠一个开关做不到。
为什么“格式化文档”有时不生效
执行 Format Document 却没改缩进，通常是因为当前语言没配默认格式化器。VSCode 本身不内置语言专属缩进逻辑，它只调用你指定的扩展（比如 esbenp.prettier-vscode 或 ms-python.python）来处理。
- 检查右下角状态栏是否显示“Prettier”“Black”或“ESLint”等格式化器名称，没显示就说明未激活
- 按
Ctrl+Shift+P输入Format Document With...，看列表里有没有可用选项；若为空，需先安装对应语言的格式化插件 - 即使装了插件，也得设为默认：在命令面板里选
Preferences: Configure Default Formatter，再选对应扩展
settings.json 中缩进配置的关键写法
全局设置容易覆盖项目需求，真正稳定的做法是语言级覆盖 + 项目级 .editorconfig 双保险。
-
"editor.tabSize"和"editor.insertSpaces"必须成对出现，单独设tabSize不影响插入行为 - 语言专属配置要用方括号包裹，比如
"[python]"，不是"python"；大小写敏感，"[Python]"无效 - HTML 推荐
"[html]": { "editor.tabSize": 2, "editor.insertSpaces": true }，但若用了 Prettier，它的规则会优先于该配置
示例片段：
{
"editor.tabSize": 2,
"editor.insertSpaces": true,
"[python]": {
"editor.tabSize": 4,
"editor.insertSpaces": true
}
}
Convert indentation to Spaces 真正的作用范围
这个命令只改当前文件的已有缩进字符，不改后续输入行为，也不影响其他文件。
- 它把所有
\t替换为对应数量的空格（按当前tabSize计算），但不会重排代码结构 - 对 Python 文件慎用：如果原文件混用 Tab 和空格，转换后可能触发
IndentationError，因为 PEP 8 明确禁止混合使用 - 批量操作需配合多文件打开：用
Ctrl+P搜*.py，全选后右键 → “Reveal in Explorer”，再逐个点开执行转换
EditorConfig 是跨编辑器一致性的唯一可靠方式
仅靠 VSCode 设置无法保证同事用 Vim 或 WebStorm 打开时缩进不变。.editorconfig 文件才是项目级事实标准。
- 必须放在项目根目录，且
root = true要写第一行，否则子目录可能被上级配置覆盖 -
indent_style设为space或tab，不能写spaces或tabs（常见拼写错误） - Go 项目要保留 Tab 缩进，就得写
indent_style = tab，同时确保 VSCode 的editor.insertSpaces在 Go 语言配置中为false
典型 .editorconfig：
root = true [*] end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true [*.py] indent_style = space indent_size = 4 [*.js] indent_style = space indent_size = 2 [Makefile] indent_style = tab
最易被忽略的是：VSCode 默认不读取 .editorconfig，必须装 EditorConfig for VS Code 插件，且该插件不随 VSCode 自带——没装就等于没写。
