VSCode“保存时格式化”需理清编辑器、语言服务器与格式化工具协作关系。默认开启无反应常因语言模式错误、扩展未安装或格式化器不可用；应按语言精细配置开关与顺序，可用codeActionsOnSave实现轻量修复，并通过工作区设置实现跨项目差异化。
VSCode 的“保存时格式化”（Format on Save）看似简单，但真正用好需要理解它和编辑器、语言服务器、格式化工具三者的协作关系。默认开启后却没反应？保存时格式错乱？不同文件类型混用不同规则？这些问题往往不是功能失效，而是配置没对齐。
确认格式化能力已就绪
VSCode 本身不提供代码格式化逻辑，它依赖安装的扩展（如 Prettier、ESLint、Black、clang-format）或语言内置支持（如 TypeScript）。保存时没反应，第一步不是调设置，而是检查：
- 当前文件是否被识别为正确语言模式（右下角显示如 “JavaScript” 而非 “Plain Text”）
- 对应语言的格式化扩展是否已安装并启用（例如 .vue 文件需 Volar 或 Vetur；.py 文件需 Python 扩展 + Black 或 autopep8）
- 运行 Ctrl+Shift+P → 输入 “Format Document With...”，看是否有可用提供者；若为空，说明没有适配的格式化器可用
按语言精细控制开关与顺序
全局开启 “Format on Save”（editor.formatOnSave）只是起点。更实用的是按语言单独管理：
- 在设置中搜索 “[javascript]”，点击 “Edit in settings.json”，添加语言专属配置
- 例如禁用某语言自动格式化：
"[typescript]": { "editor.formatOnSave": false } - 想让 ESLint 优先于 Prettier 执行？配合 editor.formatOnSaveTimeout 和扩展自身设置（如 Prettier 的 “requireConfig” 或 ESLint 的 “autoFixOnSave”）协调执行顺序
避免保存即重排——用“仅修正错误”模式
有些团队只希望保存时修复缩进、分号、引号等基础问题，而非全量重排代码结构（比如把长 if 链强行转成链式调用）。这时可关闭全量格式化，改用轻量级修复：
- 禁用 editor.formatOnSave，改用 editor.codeActionsOnSave
- 例如 JavaScript/TypeScript 项目中设置：
"editor.codeActionsOnSave": { "source.fixAll.eslint": true } - 这会触发 ESLint 的自动修复能力（需已配置 eslint.enable: true 且项目含 .eslintrc），只修规则明确允许 fix 的问题，不动结构
跨项目差异化：用工作区设置覆盖全局
你维护的 A 项目用 Prettier + 单引号，B 项目用 ESLint + 双引号。靠手动切设置太累。解决方案是：在每个项目的 ./vscode/settings.json 中写本地配置：
"editor.formatOnSave": true"editor.defaultFormatter": "esbenp.prettier-vscode"-
"prettier.singleQuote": true（Prettier 专属设置，仅在此项目生效） - VSCode 会自动优先读取工作区设置，无需每次打开都调整
基本上就这些。核心不是堆配置，而是理清“谁来格式化 → 是否启用 → 按什么规则 → 在哪生效”。搞懂这一层，保存时格式化就从玄学变成可控的日常助力。
