VS Code代码格式化不生效的三大原因是语言模式识别错误、配置层级覆盖（如.editorconfig或工作区设置优先级更高）、以及formatOnSave未正确关联到对应语言或插件；需检查右下角语言模式、配置语言专属设置、禁用ESLint与Prettier冲突规则，并明确各自职责。
VS Code 里代码格式化不生效？不是插件没装对，而是配置冲突、语言绑定或保存触发逻辑被悄悄绕过了。
formatOnSave 不起作用的三个真实原因
你点了保存，但缩进还是乱的，formatOnSave 像个摆设——大概率不是插件坏了，而是 VS Code 没把当前文件当“可格式化语言”处理。
- 检查右下角语言模式是否正确：比如一个
.js文件被识别成Plain Text，prettier或eslint就完全不会介入 -
"editor.formatOnSave": true是全局开关，但还要配"[javascript]": { "editor.formatOnSave": true }这类语言专属设置，否则 JS/TS 文件可能被忽略 - 某些扩展（如
eslint）默认只在保存时“修复问题”，不重排格式；得手动加"eslint.format.enable": true并确保eslint本身支持格式化（v8.50+ 才内置）
Prettier 和 ESLint 同时启用时谁说了算
两者都装了，结果格式化后又报 ESLint 错误，或者 ESLint 修复完又被 Prettier 打回原形——这不是 BUG，是职责没划清。
- 推荐让
Prettier只做“样式整形”（缩进、引号、换行），ESLint专注“代码质量”（未使用变量、潜在 bug） - 必须禁用 ESLint 里和 Prettier 冲突的规则：
eslint-config-prettier要装，且要在extends数组最后加载 - 关键配置项：
"prettier.eslintIntegration": false（新版已移除），改用"eslint.format.enable": true+"editor.defaultFormatter": "esbenp.prettier-vscode"，再靠eslint --fix在保存后补位
Tab Size 和 insertSpaces 被覆盖的隐藏路径
你在设置里把 tabSize 改成 2，重启 VS Code，打开新 JS 文件一看——还是 4 个空格。问题往往藏在项目级配置里。
- 优先级顺序：文件内设置（
// @tabSize 2） > 工作区.vscode/settings.json> 用户全局设置 -
.editorconfig文件会强制覆盖 VS Code 的insertSpaces和tabSize，哪怕你关掉editor.detectIndentation也无效 - 常见坑：
.editorconfig里写indent_size = 2，但没写indent_style = space，VS Code 可能仍插 Tab 字符
保存时自动排序 import 的实操条件
想保存就自动按字母序整理 import，光装 import-sort 或 es6-import-sort 不够，得让它真正接入保存链路。
- 必须启用
"editor.codeActionsOnSave": { "source.organizeImports": true }—— 这是 VS Code 原生支持的 import 排序，不依赖外部插件 - 但该功能只对语言服务器支持的类型生效：TypeScript 开箱即用；JavaScript 需开启
"javascript.suggest.autoImports": true且文件有@ts-check或.jsconfig - 如果要用自定义规则（比如把
react导入永远放最前），就得换插件如import-sort，并配置"importSort.order": ["^react", "^@?\w", "^[./]"]
真正卡住人的，从来不是“有没有插件”，而是语言模式识别失败、配置层级覆盖、以及编辑器原生能力与插件能力的边界模糊——多看一眼右下角的语言标签，比重装五次插件更管用。
