vscode代码格式化失效通常因工具未安装、未正确配置或被干扰项屏蔽。需依次确认：格式化扩展已启用并本地安装；settings.json 中开启formatOnSave、指定 defaultFormatter；语言模式识别正确；排除 Beautify 等冲突扩展及配置文件错误。
VSCode 代码格式化不起作用，通常不是“坏了”，而是某个环节没对上。核心就三点：有没有装对工具、有没有告诉 VSCode 用它、有没有被别的设置拦住。下面按真实排查顺序讲清楚。
确认格式化工具已安装并启用
VSCode 自己不格式化代码，得靠扩展。比如写 JS/TS 要用 Prettier，写 python 要用 Black，写 C ++ 要用 clang-format。
- 打开扩展面板（Ctrl+Shift+X），搜“Prettier – Code formatter”，确认状态是 已启用 ；如果是vue 项目，Vetur 或 Volar 也得开着
- 别只装用户级插件——建议在项目里本地安装：
npm install --save-dev prettier，这样 VSCode 会优先用项目里的版本，避免全局版本不兼容 - xml、go、rust等语言同理：查对应扩展是否启用，比如 Red Hat XML、Go Nightly、rust-analyzer
检查关键配置是否生效
光有插件不够，还得明确告诉 VSCode“保存时请调我”。这些配置必须写对、写准、没被覆盖。
- 必须开启自动保存格式化：
"editor.formatOnSave": true - 必须指定默认格式化程序，例如：
"editor.defaultFormatter": "esbenp.prettier-vscode"（注意 ID 别拼错） - 推荐加上
"editor.formatOnSaveMode": "modifications"，避免全文件重排引发大量 diff - 配置位置有优先级：工作区（
.vscode/settings.json）> 用户设置 > 默认设置。优先在项目里配，团队更一致
验证语言模式与文件关联是否正确
VSCode 按“语言模式”决定调哪个格式化器。如果。js文件被识别成“Plain Text”，Prettier 根本不会启动。
- 看右下角状态栏，确认当前文件的语言模式（如javaScript、typescript、Vue 等）。点它可手动切换
- 若不对，加这条到
settings.json："files.associations": {"*.vue": "vue"} - 某些后缀需显式绑定，比如
".env": "shellscript"或".jsonc": "json" - 快捷键
Shift+Alt+F没反应？先试试右键菜单“格式化文档”是否灰掉——灰了说明 VSCode 压根没识别出语言
排除常见干扰项
有时候格式化“看起来失效”，其实是被其他设置静默屏蔽了。
- 禁用冲突扩展：Beautify、ESLint（未配置协同时）、auto Rename Tag 等可能抢格式化入口。临时全禁用，只留 Prettier 测试
- 检查
prettier.requireConfig：设为false可让 Prettier 无配置文件也能运行；若设为true但项目缺.prettierrc，它就会沉默退出 - 留意项目级配置文件：.prettierrc、.editorconfig、.eslintrc.js 存在语法错误，会导致 Prettier 加载失败（无报错，只不干活）
- Mac 用户用 Settings Sync 同步后失效？很可能是 Vetur/Prettier 插件状态没同步，重装一次常能解决
基本上就这些。从插件→配置→语言识别→干扰项，一层层过，90% 的格式化失效都能当场定位。不复杂，但容易忽略某一个细节。
