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 就不会注册。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

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: write task
• 任务 type 设为 shell，command 为 npx prettier --write ...，并设 "isBackground": false
• 然后通过 Ctrl+Shift+P → Tasks: Run Task → 选它，输出会出现在 Terminal 面板

这样既复用了 CLI 的可靠性，又保留在编辑器内操作的连贯性。真正容易被忽略的是：CLI 不读 .eslintignore，也不自动跳过 node_modules —— 如果你没写 .prettierignore，它真会去格式化 node_modules/.pnpm/** 下的文件。