vscode缩进乱不是文件损坏，而是编辑器自动探测出错或插件与设置冲突；应关闭editor.detectindentation，统一editor.insertspaces、tabsize及prettier/eslint的tabwidth，并开启renderwhitespace可视化排查混用。
VSCode缩进乱不是文件坏了，是编辑器在“猜”缩进风格时出错，或格式化插件和你的设置互相覆盖。关掉自动探测、对齐关键参数、可视化排查混用，三步就能稳住。
为什么刚打开文件就缩进错位？关掉 editor.detectIndentation
VSCode 默认会读取文件前几行来决定整份文件的缩进方式。只要开头有空行、注释、或某一行混了 Tab 和空格，editor.detectIndentation 就会误判，后续所有缩进、光标跳转、甚至格式化都会偏移。
- 这不是 bug，是设计逻辑：它优先“迁就”已有内容，而不是执行你设定的规范
- 必须在项目根目录建
.vscode/settings.json，写入：{"editor.detectIndentation": false,"editor.insertSpaces": true,"editor.tabSize": 2} - 只改用户级
settings.json没用——新打开的项目仍会复现
按 Shift+Alt+F 没反应或更乱？查这三项配置是否对齐
Shift+Alt+F 触发的是 VSCode 的“格式化文档”命令，但真正动手重排的是你装的格式化器（比如 Prettier），不是编辑器自己。它和 VSCode 的缩进设置打架，就会出现“显示为 4 格，但格式化器硬改成 2 格”的撕裂感。
- 检查
editor.tabSize（VSCode 显示宽度）和prettier.tabWidth（Prettier 实际写入宽度）是否一致 - 确认
editor.insertSpaces是true，且 Prettier 配置里没设"useTabs": true - 运行
Ctrl+Shift+P→ 输入Format Document With...，看哪个格式化器被标 ✓；如果esbenp.prettier-vscode在列表里但没被选中，说明 ID 没配对
怎么一眼看出哪行混用了空格和 Tab？开 editor.renderWhitespace
默认状态下 VSCode 不显示空白字符，你看到的“对齐”可能是假象。开启可视化是最直接的排查手段：
- 在设置中搜
renderWhitespace，设为"all"：空格变成·，Tab 变成→ - Python 用户尤其要注意：混用会直接报
IndentationError；C++/Makefile 等对缩进敏感的文件，哪怕一个隐藏→都可能让构建失败 - 执行
Convert Indentation to Spaces命令前，务必先git add -p或提交当前状态——它会重写整份文件的缩进字符，Git 会标记每一行变更
粘贴后缩进全崩？禁用 editor.formatOnPaste 并手动对齐
VSCode 的粘贴逻辑默认按“光标所在行首空白”对齐，不是按语义层级。从 2 空格缩进的函数里粘贴一个为 4 空格写的 log 片段，缩进就会错位。
- 临时解法：粘贴前按
Ctrl+Shift+P→ 输入Toggle Render Whitespace，确认目标位置没有隐藏→干扰 - 长期解法：在工作区设置中加
"editor.formatOnPaste": false，避免格式化插件在粘贴瞬间重写缩进 - 自定义 snippet 时，在
body第一行手动加匹配项目tabSize的空格数，比依赖自动推导更可靠
最易被忽略的是 .editorconfig 和 .vscode/settings.json 的优先级关系：.editorconfig 会直接覆盖 VSCode 原生设置，且跨编辑器生效；而 .vscode/settings.json 又会覆盖用户级设置。团队项目里，这两个文件缺一不可，且内容必须互相对齐。
