VS Code 怎样只对当前文件启用格式化工具

如果只是想让 VS Code 当前打开的一个文件使用格式化工具，最直接的做法是运行 Format Document，而不是先打开全局的 editor.formatOnSave。需要在多个格式化器之间临时选择时，使用 Format Document With...，这次选择只服务于当前活动文件。

官方地址：https://code.visualstudio.com/docs/editing/codebasics

把光标留在目标文件中，再运行 Format Document 或 Format Document With...，就能完成一次“只处理当前文件”的格式化。它和用户设置、工作区设置不是一回事。

先确认当前文件和语言模式

先在 VS Code 中打开需要整理的文件，并确认它仍是编辑器当前活动标签。格式化器按语言提供能力，如果右下角的 Language Mode 与文件实际内容不一致，命令可能没有合适的格式化器可用。

1. 打开目标文件，例如 demo.js，不要只在 Explorer 中选中它。
2. 查看右下角语言模式；JavaScript、TypeScript、JSON、HTML 和 CSS 等语言通常可以使用 VS Code 的内置格式化支持，其他语言则可能需要对应扩展。
3. 如果模式不正确，点击语言模式并选择真实语言。只要目标文件保持活动状态，后面的命令就会以它为作用对象。

用 Format Document 只格式化当前文件

确认文件处于活动状态后，可以使用下面任一入口：

• 打开命令面板，输入并选择 Format Document。
• macOS 使用 Shift+Option+F；Windows 使用 Shift+Alt+F；Linux 使用 Ctrl+Shift+I。
• 在编辑器中打开右键菜单，选择格式化文档。

VS Code 官方文档将这个命令定义为格式化整个活动文件；如果只选中一段内容，则应使用 Format Selection。这两种操作都不会因为一次手动调用而把其他文件一起格式化，也不需要修改 settings.json。

这里要区分两个容易混淆的设置：editor.formatOnSave 是保存文件时自动格式化，editor.formatOnType 是输入时格式化。它们属于持久化设置，不是“当前文件临时执行一次”。如果本次需求只是整理一个文件，保持它们关闭更符合目标。

多个格式化器时选择本次使用的工具

同一种语言可能同时安装多个格式化扩展。此时打开命令面板，运行 Format Document With...，在列表中选择本次要使用的格式化器。选择后，仍然要把目标文件留在活动编辑器中。

如果菜单中同时出现具体格式化器和 Configure Default Formatter，两者含义不同：

如果列表为空，先检查语言模式和扩展是否提供该语言的 formatter；不要为了让菜单出现而随意打开自动保存格式化。

需要反复调用时，用快捷键固定格式化器

偶尔一次操作用命令面板就够了。如果经常只想让当前活动文件使用某个格式化器，可以在快捷键文件中调用 VS Code 提供的多格式化器命令。官方说明中，editor.action.formatDocument.multiple 可以通过 formatter 参数指定扩展标识符；它是在快捷键运行时选择格式化器，不等于修改 editor.defaultFormatter。

打开命令面板，执行 Preferences: Open Keyboard Shortcuts (JSON)，加入下面的 JSON。JSON 本身不能写注释，因此字段含义放在代码块外说明：key 是快捷键，command 指定格式化命令，args.formatter 写格式化扩展的标识符，when 限制为编辑器获得焦点且文件可编辑。

{
  "key": "ctrl+alt+f",
  "command": "editor.action.formatDocument.multiple",
  "args": {
    "formatter": "esbenp.prettier-vscode"
  },
  "when": "editorTextFocus && !editorReadonly"
}

这个快捷键的配置文件本身是持久化的，但每次触发命令时，格式化范围仍是当前活动文档。把 esbenp.prettier-vscode 换成已安装格式化器的真实标识符；如果该格式化器不支持当前语言，VS Code 不会替它强行处理文件。

官方快捷键说明：https://code.visualstudio.com/docs/configure/keybindings

常见误区和最后确认

最常见的误区是把“当前文件执行一次”写成“只为一个文件保存设置”。VS Code 的 User、Workspace、Workspace Folder 和 Language-specific settings 都是配置作用域；它们适合长期规则，不适合一次性整理某个文件。

完成后可以按这三个问题确认操作范围：

1. 执行命令前，目标文件是否确实是活动编辑器？
2. 这次是否选择了 Format Document 或 Format Document With...，而不是保存自动格式化设置？
3. 是否只看到当前文件内容发生格式化变化，而没有把操作误认为整个工作区的批量任务？

相关问题

Format Document 和 Format Selection 有什么区别？

前者格式化整个活动文件，后者只格式化当前选中的文本范围。

为什么 Format Document With... 没有列出我的工具？

通常先检查当前语言模式，再确认扩展是否声明了该语言的格式化能力；一个扩展已安装并不代表它支持所有语言。

怎样避免保存时自动格式化其他文件？

不要把本次单文件需求改成全局或工作区的 editor.formatOnSave；直接在目标文件活动时手动运行格式化命令即可。