VSCode保存时自动格式化需同时开启files.autoSave、editor.formatOnSave和语言级editor.defaultFormatter三重配置，缺一不可；仅开formatOnSave而未指定对应语言的默认格式化器将导致Ctrl+S无效。

VSCode 保存时自动格式化不会默认生效，哪怕你已经装了 Prettier 或 Black —— 它连“该用谁”都不知道，必须手动配对语言、格式化器和触发开关。

为什么 Ctrl+S 只保存不格式化？

常见错误是只开了 editor.formatOnSave，却没指定默认格式化器，或者当前文件类型没匹配上。

• 右下角状态栏显示的语言模式（如 JavaScript）和实际激活的格式化器（如 Prettier）必须一致；若显示 None，说明 VSCode 找不到适配器
• 按 Shift+Alt+F 能格式化，但保存不行 → 大概率是 editor.defaultFormatter 没为该语言设好
• 多个格式化扩展共存（比如同时启用 esbenp.prettier-vscode 和 dbaeumer.vscode-eslint）会导致反复调用、光标跳动甚至格式错乱

如何为 JavaScript/TypeScript 正确绑定 Prettier

不能只靠全局 editor.defaultFormatter，否则 Vue、JSON 等文件也会被强行用 Prettier 处理，可能出错。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在 settings.json 中按语言单独配置，例如：

  "[javascript]": {
    "editor.defaultFormatter": "esbenp.pretterrc-vscode"
  },
  "[typescript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }

• 确保已安装 esbenp.prettier-vscode 扩展，并处于启用状态（Ctrl+Shift+X 搜索确认）
• 项目根目录有 .prettierrc 时，Prettier 会自动读取；没有也不影响基础功能，但团队协作建议补上

Python 用户必须额外检查这个配置项

即使 editor.formatOnSave 和 editor.defaultFormatter 都设好了，ms-python.python 扩展仍需要显式指定后端工具。

• 必须设置 python.formatting.provider，值为 "black"、"autopep8" 或 "yapf" 之一
• 对应配置示例：

  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "python.formatting.provider": "black"
  }

• 如果用的是 ms-python.black-formatter 这类专用 formatter 扩展，python.formatting.provider 可省略，但 editor.defaultFormatter 必须指向它

格式化不生效？先看这三个开关是否全开

VSCode 的保存格式化是三重门：自动保存要开、格式化触发要开、语言级默认格式器也要开。缺一不可。

• files.autoSave：必须不是 "off"（默认值），推荐设为 "onFocusChange" 或 "afterDelay"
• editor.formatOnSave：必须为 true，且不能被工作区设置覆盖（检查右下角齿轮图标是否显示“工作区”）
• editor.defaultFormatter：不能只写全局值，要配合语言块（"[python]"）或文件关联（"files.associations"）精确控制

最容易被忽略的是：同一项目里 .vscode/settings.json 和用户级 settings.json 冲突时，前者优先，但很多人改了用户设置却忘了删工作区里的 "editor.formatOnSave": false。