VS Code格式化失效主因是language mode错误、配置层级覆盖或插件协作失败；需确认右下角语言标识正确、workspace settings中editor.defaultFormatter和formatOnSave已启用，并检查Output面板报错。
检查当前文件的 language mode 是否正确
VS Code 的格式化功能高度依赖 language mode（比如 javascript、typescriptreact、jsonc），如果右下角显示的是 Plain Text 或错误的语言，Format Document 就会失效或用错规则。
- 点击右下角语言标识（如 “JavaScript”），手动选对 language mode；临时改错会导致
prettier或eslint插件完全不触发 - 对 .ts 文件误设为
typescriptreact，可能让prettier忽略semi: false配置；反之亦然 - 某些自定义后缀（如
.config.js）需在settings.json中显式映射："files.associations": {"*.config.js": "javascript"}
确认 format on save 是否真正生效
editor.formatOnSave 看似开了，但常被其他设置覆盖或插件拦截，尤其在多人协作项目中。
- 按
Ctrl+,打开设置，搜format on save，确保勾选的是 *User* 和 *Workspace* 两级都生效（Workspace 优先级更高） - 检查是否有冲突插件：比如同时装了
ESLint和Prettier，且未配置"eslint.format.enable": true，则保存时只会跑 ESLint 自带的简易格式化，而非你配的 Prettier 规则 - 终端执行
code --list-extensions看是否启用了禁用格式化的插件（如某些主题或代码片段插件会悄悄关掉 formatter）
验证 formatter 配置是否被 workspace settings 覆盖
项目根目录下的 .vscode/settings.json 会覆盖全局设置，而它经常被 gitignore 或手误删掉，导致格式化行为“突然变样”。
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Open Workspace Settings (JSON)，确认存在类似配置：
{
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true,
"prettier.semi": false,
"prettier.singleQuote": true
}"eslint.format.enable": true，否则 VS Code 默认只用 ESLint 修复语法错误，不格式化空格/换行@/ 别名，prettier 默认不识别，需配 "prettier.importOrderParserPlugins": ["typescript"] 并确保插件版本 ≥ 9.0.0手动触发 format 并观察输出面板报错
快捷键 Shift+Alt+F（Windows/Linux）或 Shift+Option+F（Mac）不是万能的——它可能静默失败，关键要看 Output 面板里的具体日志。
- 打开
View → Output，在右上角下拉菜单里选ESLint或Prettier，看有没有类似Failed to load config "prettier/react" to extend from的报错 - 常见坑：
node_modules/.bin/prettier路径不对（尤其用 pnpm），或本地安装了prettier@3.x但插件仍用旧版 API，此时要删掉node_modules重装 - 如果输出里出现
No valid configuration found，说明 Prettier 没找到prettier.config.js或.prettierrc，且没 fallback 到插件默认值（部分旧版本会 fallback，新版本直接跳过）
格式化问题大多卡在 language mode、配置层级覆盖、插件间协作这三环上，而不是代码本身。最容易被忽略的是 workspace settings 里那几行看似不起眼的 defaultFormatter 和 formatOnSave，它们一旦被注释或拼错，整个流程就断在第一环。
