最常见原因是当前文件未绑定格式化程序，VSCode仅对已知语言启用格式化；若状态栏显示“Plain Text”或“Unknown”，需手动切换语言模式并安装对应格式化扩展。
快捷键 Shift+Alt+F 按下后完全没反应
最常见原因是当前文件没绑定任何格式化程序，VSCode 默认只对已知语言（如 javascript、python）启用格式化，而对纯文本或未识别后缀的文件（比如 foo.config）直接禁用。检查右下角状态栏：如果显示“Plain Text”或“Unknown”，就说明 VSCode 根本没把它当可格式化文件处理。
实操建议：
- 点击右下角语言模式（如“Plain Text”），输入真实语言名（如
json、typescript）并回车，强制切换语言模式 - 确认文件后缀是否被正确识别——把
.ts写成.js会导致 TypeScript 文件走 JS 格式化器，而它很可能不支持 TS 语法，从而静默失败 - 按
Ctrl+Shift+P输入Format Document With...，看列表是否为空；为空即代表没装对应语言的格式化扩展，或扩展未激活
按了 Shift+Alt+F 后弹出“There is no formatter for ‘xxx’ files installed”
这个提示很直白：VSCode 找不到能处理当前语言的格式化工具。注意，“没安装”不等于“没装扩展”——可能是扩展没启用、配置被覆盖，或者格式化能力被显式禁用了。
实操建议：
- 打开扩展面板（
Ctrl+Shift+X），搜你用的语言（如esbenp.prettier-vscode），确保已启用且不是“工作区禁用”状态 - 检查设置里有没有写死禁用：搜索
editor.formatOnSave，顺带看一眼[javascript]或[typescript]这类语言专属设置块，里面可能有"editor.formatOnSave": false这种覆盖项 - 某些扩展（如 Prettier）需要手动指定默认格式化器：按
Ctrl+Shift+P→Preferences: Configure Language Specific Settings...→ 选语言 → 加入"editor.defaultFormatter": "esbenp.prettier-vscode"
格式化时卡住、报错或输出乱码（比如 Cannot find module 'prettier'）
本质是格式化器运行环境缺失或路径错乱。VSCode 可以从全局 Node、项目本地 node_modules、甚至扩展自带副本里找格式化器，但优先级和路径解析容易出问题，尤其在使用 pnpm / yarn v4+ 或多根工作区时。
实操建议：
- 在项目根目录运行
npx prettier --version（或对应格式化器命令），确认 CLI 能正常执行；如果报错，先解决本地依赖问题 - 检查 VSCode 设置里的
prettier.prettierPath是否指向了一个不存在的路径，或错误地指向了全局安装位置（比如/usr/local/lib/node_modules/prettier），而项目实际用的是 pnpm 的虚拟链接 - 关闭所有窗口，删掉
.vscode/extensions缓存（非必要但有效），重装格式化扩展——某些扩展更新后会残留旧版 node_modules 引用
在远程开发（SSH / WSL / Containers）中格式化失效
远程场景下，格式化器必须装在远程环境，而不是本地。VSCode 本地进程无法调用本地的 Prettier 去格式化远程文件，这是最常被忽略的点。
实操建议：
- 连上远程后，在远程终端里运行
which prettier或npm list -g prettier，确认命令存在且版本可用 - 不要在本地设置
prettier.prettierPath指向本地路径，这在远程会直接失效；应改用远程绝对路径（如/home/user/.nvm/versions/node/v18.18.2/bin/prettier），或干脆删掉该配置让扩展自动查找 - 检查远程 VSCode Server 日志：按
Ctrl+Shift+P→Developer: Toggle Developer Tools→ Console 标签页，执行格式化时看是否有spawn ENOENT类错误，基本就是路径或权限问题
真正麻烦的从来不是快捷键本身，而是格式化器、语言服务、远程环境、项目依赖这四层之间的隐式耦合——少一个环节对不上，就会变成“按了但像没按”。调试时盯住右下角语言模式、命令面板的格式化菜单、开发者工具控制台这三处，比反复重启 VSCode 有用得多。
