VS Code 怎样让保存时自动格式化指定语言

如果只想让 TypeScript、Python 或其他某一种语言在保存时自动整理格式，关键不是打开全局开关，而是把 editor.formatOnSave 放进对应的语言专属设置。这样目标文件保存后会格式化，其他语言仍按原来的规则工作。

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

一、先确认语言模式和可用格式化器

打开要配置的文件，先看右下角的语言模式。例如文件实际按 TypeScript 解析，语言标识通常应写成 typescript；如果这里显示的是 Plain Text，保存时自然不会调用 TypeScript formatter。

然后按 Command Palette → Format Document，或使用编辑器右键菜单中的 Format Document。如果出现格式化器选择，说明当前语言存在多个候选；选择项目实际使用的 formatter，并记住它的名称。

这一步的验收信号是：状态栏显示了正确语言，手动格式化能产生结果，或者至少能弹出 formatter 选择器。没有可用 formatter 时，先安装并启用目标语言的格式化扩展，再继续配置。

二、在语言专属设置中打开保存格式化

按 Command Palette → Preferences: Configure Language Specific Settings，选择目标语言。若编辑器使用图形化设置页，可以在设置搜索框输入 @lang:typescript；若要明确看到配置结构，直接进入该语言的 settings.json 区域。

下面是一个最小配置。它是严格 JSON，因此不在代码块中添加注释；语言标识和每个字段的作用放在代码块外说明：

{
  "[typescript]": {
    "editor.formatOnSave": true
  }
}

[typescript] 只匹配 TypeScript 语言模式，editor.formatOnSave 负责在保存动作发生时触发格式化。若配置 Python，改为 [python]；不要把扩展名直接写成 [.ts]。

设置作用域要按使用场景选择：只影响自己的所有项目时放在 User；只影响当前项目时放到工作区的 .vscode/settings.json。同一语言同时出现在用户和工作区时，工作区设置会覆盖用户设置，因此团队项目更适合把约定写进工作区。

三、选择作用域并核对保存结果

回到目标文件，故意制造一个明显的缩进或换行差异，然后保存。正确生效时，编辑器会在保存动作后把代码整理成 formatter 的格式；可以再执行一次 Format Document，如果内容不再发生变化，说明保存格式化与手动格式化结果一致。

接着打开一个没有配置的语言文件保存一次，例如同一工作区里的 Markdown 文件。它不应因为 TypeScript 的语言块而被格式化。这个反向检查能排除误把开关写成全局 "editor.formatOnSave": true 的情况。

四、不生效时按证据排查

• 保存没变化：先检查右下角语言模式，再确认该语言存在 formatter，最后查看 Format Document With… 是否选中了正确的默认 formatter。
• 弹出多个 formatter：选择项目约定的 formatter，并避免同时启用会处理同一语言的重复扩展。
• 配置像是没被读取：检查语言块拼写、JSON 逗号和作用域；工作区设置可能覆盖用户设置。
• 格式被反复改写：确认保存时 formatter 与项目的 lint 或代码操作没有对同一文件执行冲突修改。

最终可以用一个简单清单收尾：目标语言模式正确、语言块中的开关为 true、默认 formatter 已选定、目标文件保存后不再产生额外格式差异、未配置语言没有被连带修改。

相关问题

能不能只对当前项目开启？

可以，把语言专属设置写入当前工作区的 .vscode/settings.json。这样配置会随项目共享，其他工作区不会自动继承。

打开开关后为什么还是不格式化？

通常是语言模式不匹配、没有可用 formatter，或工作区设置覆盖了用户设置。先手动执行 Format Document，再检查默认 formatter 和实际生效的语言块。