Format Document命令搜不到，是因为文件语言模式错误、格式化扩展未安装启用或未声明支持格式化接口；需检查右下角语言标识、扩展状态及editor.defaultFormatter配置。
Ctrl+Shift+P 输入 “Format Document” 或 “Format Selection” 是最直接的手动触发方式，但前提是命令存在——它不生效，往往不是你按错了，而是环境没配齐。
为什么 Format Document 命令在命令面板里搜不到？
VSCode 不会为所有文件类型注册格式化命令。它只在满足以下全部条件时才显示 Format Document 和 Format Selection：
- 当前文件右下角语言模式正确（比如显示
JavaScript，而不是Plain Text或Markdown） - 该语言对应的格式化扩展已安装且启用（例如
esbenp.prettier-vscode对 JS/TS，ms-python.python+black对 Python） - 扩展已声明支持
DocumentFormattingEditProvider（全文件）或DocumentRangeFormattingEditProvider（选区）
常见假象：你点了右下角切成了 JavaScript，但插件没装、没设为默认、或配置里 editor.defaultFormatter 为空，命令依然不会出现。
手动触发失败时，怎么快速验证是哪一环断了？
打开命令面板（Ctrl+Shift+P），依次执行：
- 输入
Developer: Toggle Developer Tools→ 切到 Console 标签页，看有没有报错（如Cannot find module 'prettier'） - 输入
Developer: Inspect Editor Tokens and Scopes→ 点击编辑器任意位置，确认 Language ID 显示是否为你期望的（如javascript，不是plaintext） - 输入
Preferences: Configure Language Specific Settings...→ 选当前语言 → 检查editor.defaultFormatter是否有值（如"esbenp.prettier-vscode"）
这三步比反复重绑快捷键更省时间。只要其中一项为空或报错，Format Document 就不会注册。
npx prettier --write 是唯一绕过 VSCode 环境的手动方式
当编辑器内一切失灵，或者你要处理未打开的文件、被 .gitignore 排除但需格式化的配置文件，就得用 CLI：
- 确保项目根目录有
package.json，且prettier在devDependencies中（或能被npx自动下载） - 运行：
npx prettier --write "**/*.{js,ts,jsx,tsx,css,scss,html,json,md}"（Windows/Linux，macOS 同理） - 加
--ignore-unknown防止遇到.env或.yml报错中断 - 首次运行建议先用
--check查看哪些文件会被改，避免误操作
注意：**/* 必须用双引号包裹，否则 shell 可能提前展开 glob，漏掉深层嵌套路径；.prettierignore 文件必须写相对路径（如 dist/），不能带 ./ 或绝对路径。
VSCode 里一键调用 CLI 的安全做法
别用自定义快捷键硬绑 npx prettier，容易因终端环境变量、pnpm/yarn pnp、或工作区路径错乱导致失败。推荐方式是：
- 在项目根目录建
.vscode/tasks.json，定义一个prettier: writetask - 任务 type 设为
shell，command 为npx prettier --write ...，并设"isBackground": false - 然后通过
Ctrl+Shift+P→Tasks: Run Task→ 选它，输出会出现在 Terminal 面板
这样既复用了 CLI 的可靠性，又保留在编辑器内操作的连贯性。真正容易被忽略的是：CLI 不读 .eslintignore，也不自动跳过 node_modules —— 如果你没写 .prettierignore，它真会去格式化 node_modules/.pnpm/** 下的文件。
