VSCode怎么配置代码保存时自动格式化

VSCode保存时自动格式化：三个条件少一个，Ctrl+S都白按

VSCode保存时自动格式化这个功能，看起来像是“装个插件就完事”的小事，但很多人折腾了半天还是没反应。其实核心就三件事：editor.formatOnSa ve要打开，对应语言的editor.defaultFormatter要指定明确，那个格式化插件得装好并且被VSCode认出来。这三个条件，缺一个，你按Ctrl+S就真的只是保存，代码不会动一行。

确认当前文件有可用的格式化提供者

VSCode自己不直接处理格式化逻辑，全靠扩展来干活。判断方法很简单：看右下角状态栏里的语言模式——比如Ja vaScript React——它必须和你装的格式化扩展支持范围匹配。

可以试试按下Ctrl+Shift+P，输入Format Document With，如果弹出的列表是空的，或者只有None，那说明扩展没装对，或者装了但没激活。

不少JS/TS项目踩过这个坑：装了esbenp.prettier-vscode，但没在工作区里启用；或者更糟糕，装了Prettier、ESLint、js-beautify好几个，结果互相冲突，静默失败。

Python用户尤其要注意：ms-python.python只是语言支持包，它不负责格式化。真正干活的是ms-python.black-formatter，或者你需要在设置里把python.formatting.provider指定为black。

至于Go、Rust这类语言，需要官方插件（比如golang.go），而且gopls语言服务器必须启动成功，才会提供格式化能力。如果没反应，可以去输出面板里翻翻对应扩展的日志。

开启editor.formatOnSa ve并配对语言设置

这个开关默认是false，你不手动打开，它永远不触发。不过，只打开开关还不够——VSCode还需要知道该叫谁来干活。

最直接的方法是在全局设置里写上"editor.formatOnSa ve": true，但不推荐在团队项目里这么干。更稳妥的做法是按语言覆盖：比如这样写——"[ja vascript]": {"editor.formatOnSa ve": true, "editor.defaultFormatter": "esbenp.prettier-vscode"}。

语言ID必须小写，而且要准确。比如typescriptreact，不是tsx。如果不确定，点一下右下角的语言名就能看到。

还有个容易掉进去的坑：项目根目录下的.vscode/settings.json会覆盖全局设置。如果里面写了"editor.formatOnSa ve": false，那整个项目里这个功能都无效。

处理多formatter共存时的冲突

当一个文件类型被多个扩展声称能格式化——比如JS同时装了Prettier和ESLint插件——VSCode可能会卡住、跳光标，甚至格式错乱。因为它会尝试让所有可用的formatter都跑一遍。

解决办法也很直接：右键编辑器空白处，选择Format Document With，选中你想要的格式器，然后点Configure Default Formatter。这会自动在.vscode/settings.json里写入类似"[ja vascript]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}这样的配置。

如果确定只用Prettier，那干脆禁用其他不在计划内的扩展，比如HookyQR.beautify，或者旧版ESLint的自动格式化功能。

ESLint最好只用来做检查，修复操作交给editor.codeActionsOnSa ve来控制："source.fixAll.eslint": true。别让它也参与formatOnSa ve，否则容易出乱子。

大项目里格式化慢了？可以改用延迟触发："editor.formatOnSa veAfterDelay": 750，避免保存瞬间卡顿。

最容易被忽略的一点是：语言设置和formatter扩展必须严格匹配。比如你给[python]配了esbenp.prettier-vscode，保存时只会静默失败——VSCode不报错、不提示，它只是跳过。所以真正生效前，务必手动执行一次Format Document（Shift+Alt+F），确认工具是否真的就位。