VSCode自动缩进失效主因是语言模式错误（如Plain Text）、detectIndentation干扰或格式化器冲突；需确认右下角语言标识、关闭detectIndentation、检查formatOnPaste/formatOnType及.editorconfig覆盖。
VSCode 不自动缩进，不是 editor.autoIndent 开关没开，而是它根本没被调用——语言模式错、格式化引擎没绑定、或被 editor.detectIndentation 干扰了。
右下角语言模式是不是“Plain Text”？
这是 90% 自动缩进失效的第一原因。VSCode 所有缩进逻辑都由当前语言模式驱动，Plain Text 模式下 editor.autoIndent 形同虚设。
- 点击状态栏右下角语言标识，确认显示的是
JavaScript、Python、HTML或Vue，不是Plain Text -
.vue文件必须选Vue（非HTML或JavaScript），否则<template>内部不触发任何缩进 -
.py文件若误判为Plain Text，editor.insertSpaces和editor.tabSize全部失效
editor.autoIndent 开了但没反应？检查 detectIndentation 干扰
editor.detectIndentation 默认开启，它会读文件前几行就决定全文件用空格还是 Tab、缩进几格。一旦开头有注释、空行或混排，后续换行缩进就会错位。
- 在项目根目录
.vscode/settings.json中显式关闭："editor.detectIndentation": false - 同时固定缩进风格：
"editor.insertSpaces": true+"editor.tabSize": 2（按项目实际需要改） - 已错乱的文件：全选 →
Ctrl+Shift+P→ 输入Convert Indentation to Spaces统一后再关detectIndentation
粘贴/换行后缩进崩了？formatOnPaste 和 formatOnType 在偷偷接管
editor.formatOnPaste 和 editor.formatOnType 默认是 false，但一旦打开，它们会绕过 autoIndent 直接调用格式化器（如 Prettier）。如果格式化器配置和当前代码风格冲突，就会把刚打好的缩进“拉平”。
- 先临时关掉这两个选项，测试换行是否恢复正常；若恢复，说明问题出在格式化器
- 检查
.prettierrc是否与编辑器设置冲突，例如：editor.tabSize: 2但"tabWidth": 4 -
editor.formatOnPaste必须写在 settings.json 顶层，不能嵌套在"[javascript]": {}里，否则对当前文件无效
保存时缩进仍错乱？优先级链断了
VSCode 缩进行为由四层叠加：用户级 > 工作区级 > 语言专属级 > 扩展级。哪怕你在用户设置里设了 tabSize: 2，只要项目根目录有 .editorconfig 或 .vscode/settings.json，它们就可能覆盖你。
- 按
Ctrl+Shift+P→Preferences: Open Settings (JSON)，检查有没有重复定义editor.tabSize或editor.insertSpaces - 留意
.editorconfig文件里的indent_style和indent_size，它比 VSCode 设置优先级更高 - 多语言文件（如
.vue）需单独配语言块："[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
真正卡住缩进的，往往不是某个开关没开，而是语言模式、编辑器设置、格式化器三者之间有一处没对齐。尤其注意 .editorconfig 和工作区 settings.json 的隐式覆盖，它们比你手动点开的 UI 设置更“强势”。
