shift+alt+f没反应是因为prettier未激活：插件未安装、项目缺少prettier包或defaultformatter未设为esbenp.prettier-vscode；需检查右下角语言模式、format document with列表及.vscode/settings.json配置。
Shift+Alt+F 没反应？先确认三要素是否就位
VS Code 不自带格式化逻辑，Shift+Alt+F 只是触发指令，真正干活的是你配置的格式化器链。缺一不可：Prettier - Code formatter 插件已安装、项目里有 prettier 包（npm install --save-dev prettier）、editor.defaultFormatter 明确指向 esbenp.prettier-vscode。
常见断点：
- 右下角语言模式显示为
Plain Text或JavaScript React（Prettier 默认不响应后者），需手动点开并选成JavaScript -
Format Document With命令面板（Ctrl+Shift+P）里没出现Prettier选项 → 说明链路已断 - 全局设置了
editor.defaultFormatter，但项目根目录.vscode/settings.json里又覆盖为空或指向其他插件（如dbaeumer.vscode-eslint）
保存自动格式化失效？检查作用域和 mode 设置
开启 editor.formatOnSave 后仍无反应，大概率是规则没落到具体语言上。全局开关只是“允许”，不等于“启用”。
推荐做法：
- 在项目根目录建
.vscode/settings.json，而非改用户级设置，避免误伤其他项目 - 显式绑定语言：
"[javascript]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" } - 大文件慎用全量格式化：加
"editor.formatOnSaveMode": "modifications"，只处理改动行，避免整文件重排引发 Git 冲突 - JSON、HTML 等非 JS 文件需单独声明：
"[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
Prettier 和 ESLint 一起用，代码越整越乱？这是规则打架
典型症状：保存一次加了分号，再保存又被删掉；对象属性换行反复跳动。这不是 VS Code 故障，是两个工具都在写同一份 AST。
解法不是禁用其中一个，而是让它们分工：
- 用 Prettier 负责“怎么排版”（缩进、换行、引号），关闭 ESLint 的格式类规则（如
semi、comma-dangle） - 装
eslint-config-prettier并在.eslintrc.js末尾追加extends: ['prettier']，它会主动关掉所有与 Prettier 冲突的规则 - 若用
yarn v4+或pnpm，Prettier 插件可能找不到本地包，需显式配"prettier.prettierPath": "./node_modules/prettier/index.cjs"
右键“格式化文档”灰色不可点？语言识别或插件未激活
右键菜单项是否可用，取决于 VS Code 是否成功加载该语言的服务提供者。灰色 = 没注册格式化器，或根本没识别出语言类型。
排查步骤：
- 新建一个
test.js，粘段代码，右键看是否可点 —— 如果能点，说明原文件后缀没被关联（比如叫config或app） - 右下角点击语言名 → “更改语言模式” → 手动选目标语言（如
TypeScript） -
.vue文件需注意：Vetur 插件把 template/script 分区，右键必须落在对应区域才显示对应格式化项 - 打开“输出”面板（
Ctrl+Shift+U），选Prettier或Log (Window)，看是否有Cannot find module 'prettier'类报错
最隐蔽的坑是：项目用了 pnpm/yarn v4+ 且没配 prettierPath，插件启动时静默失败，右键菜单直接消失——此时命令面板里也搜不到 Format Document。
