VS Code 自动格式化不生效怎么办：默认格式化程序、保存触发和语言模式这样查

保存 Go、JavaScript 或 JSON 文件后，缩进还是原样，很多人第一反应是把扩展卸了再装。其实更常见的是：当前文件没有被识别成目标语言，或者 VS Code 不知道该把哪个格式化器当成默认项。先让“格式化文档”手动跑通，再检查保存触发，通常几分钟就能定位问题。

自动格式化失效不用上来就重装扩展，按手动格式化、语言模式、默认格式化器、保存触发、工作区覆盖的顺序排查，大部分常见场景都能快速解决。

先用一次“格式化文档”把问题分成两类

打开一份确实需要整理缩进的文件，按 Ctrl+Shift+P（macOS 为 Shift+Command+P），搜索并选择“格式化文档”。也可以在编辑器内右键寻找同名操作。这个动作相当于一把很短的尺子：它能运行，说明语言支持和至少一个格式化器大概率已经可用；它完全没有效果或提示找不到格式化器，问题还在保存开关之前。

这里别急着改一大段 settings.json。先看窗口右下角的语言标识：它显示 Plain Text 时，JavaScript、Go 等语言扩展通常不会按预期接管当前文件。点击这个标识，或从命令面板运行“更改语言模式”，把它切成文件真正所属的语言，再试一次手动格式化。

最小修复：默认格式化程序与保存触发要同时成立

手动格式化能工作、保存却没反应，最小处理路径只有两步：先用“使用…格式化文档”选中想用的格式化器并设为默认；再在设置中打开 Editor: Format On Save。VS Code 的官方文档把 editor.formatOnSave 定义为保存文件时触发格式化的设置；它不会替你安装缺失的格式化器。

如果团队只希望某一种语言自动整理，可以把开关缩到语言范围，避免 Markdown、配置文件也被意外改动：

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

这段设置的边界很明确：它只负责在保存时发起格式化。若当前语言安装了多个候选格式化器，仍应通过“使用…格式化文档”确认默认项；若一个格式化器本身报错，开关保持为 true 也不会让文件变整齐。

设置写对了，为什么保存后还是没有变化

先看设置右上方的范围。用户设置适合个人习惯；工作区设置放在项目目录的 .vscode/settings.json 中，适合团队统一规则。两个地方写了同一个键时，项目范围的值可能覆盖你的个人选择。排查时把设置界面切换到工作区，再搜索 format on save，通常就能看到是哪一层在生效。

第二个常见误区是把“保存”当成“所有工具都会自动改文件”。有些语言扩展只提供诊断、补全或高亮，并不提供格式化；也有格式化器依赖项目内的配置文件。手动运行一次格式化文档，观察通知、输出面板或该扩展的提示，比盯着保存按钮更有用。先让一次手动动作成功，再回头验证自动触发，路径会短很多。

用三次保存做最后核对

把一行对象字面量或函数参数故意打乱，保存一次，确认缩进和换行变化；再关闭 Editor: Format On Save 保存一次，确认文件不再变化；最后重新打开开关并保存。三次结果分别对应“格式化器可用、开关真的被读取、恢复后触发正常”。这样比只看一个勾选状态可靠。

如果团队要把规则固定下来，可以把确认过的语言范围设置放入项目的 .vscode/settings.json，并在代码评审中观察是否出现大面积无关格式变更。格式化应当减少噪音，而不是让每次提交都变成无关文件的重排。

相关问题

“格式化文档”能用，但只保存时不生效，优先查哪里？

优先搜索 Editor: Format On Save，再检查该设置是在用户范围还是工作区范围。语言范围设置和项目设置都可能影响最终结果。

为什么 VS Code 总是要求我选择格式化器？

同一种语言可能有多个已安装扩展提供格式化能力。通过“使用…格式化文档”选择并设为默认，后续保存才有稳定的目标。

文件被识别成 Plain Text 会怎样？

语言扩展通常按语言模式提供功能。先从状态栏切换到正确语言，再确认扩展是否真的支持该语言的格式化。

能否只让 JavaScript 在保存时格式化？

可以。把 editor.formatOnSave 放在 [javascript] 这类语言范围设置中；先确认该语言已有可用的默认格式化器。

把问题留在“设置层”，别让它变成重装循环

自动格式化不生效时，顺序比复杂度重要：手动格式化、语言模式、默认格式化程序、保存触发、工作区覆盖。沿着这五个点检查，能把“扩展有没有装”“哪个设置在管”“保存是否真的触发”拆开。处理完后保留一次小范围的保存测试，下一次换项目或换语言也能很快复用这条路径。