VSCode保存时自动格式化需同时满足三个条件：插件已安装并设为默认、editor.formatOnSave: true、当前文件类型被该格式化器支持；缺一不可，否则Ctrl+S仅保存不格式化。
VSCode 保存时自动格式化不是“开了开关就完事”，它必须同时满足三个条件：插件已安装并设为默认、editor.formatOnSave 为 true、且当前文件类型被该格式化器支持。少一个，Ctrl+S 就只是保存，不会动一行代码。
editor.formatOnSave 开关在哪配、为什么单独开没用
这个配置控制“是否在保存时触发格式化”，但它本身不决定“谁来格式化”。只写 "editor.formatOnSave": true 而不指定格式化器，VSCode 会默默跳过——因为不知道该调哪个工具。
- 推荐直接编辑
settings.json（按Ctrl+,→ 右上角齿轮图标 → “Open Settings (JSON)”），加这一行即可 - 别只依赖 GUI 勾选，某些工作区设置会覆盖用户级设置，最终生效的是最内层的配置（如项目根目录下的
.vscode/settings.json） - 如果只想对某类文件启用（比如只对
.ts文件），应使用语言专属配置："[typescript]": { "editor.formatOnSave": true }
defaultFormatter 必须按语言指定，不能全局硬塞
VSCode 不允许你用一个格式化器通吃所有语言。比如把 esbenp.prettier-vscode 设为全局 editor.defaultFormatter，遇到 .py 文件时可能报错或静默失败。
- 正确做法是为每种语言单独声明：
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }、"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 检查是否生效：打开一个
.js文件，看右下角状态栏是否显示Prettier；若显示None，说明没配对或插件未启用 - 右键文件标签 →
Format Document With→ 点击Configure Default Formatter，可交互式完成这一步
格式化没反应？先查 console 和状态栏，别急着重装插件
常见假性失效，其实不是插件坏了，而是环境链断了。打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），切到 Console 标签页，保存一次，看有没有类似这样的报错：
Failed to format document: Error: No formatter registered for 'typescript'
这意味着 VSCode 找不到能处理 .ts 的格式化器——可能插件没装、没启用、或语言 ID 不匹配（比如你用的是 typescriptreact，但只配了 [typescript]）。
- 确保插件已启用：扩展面板搜
prettier或black，确认有绿色“已启用”标识 - Python 用户额外注意：
ms-python.python扩展需配合python.formatting.provider设置（如"black"），否则formatOnSave形同虚设 - 格式化卡顿或超时？加一行
"editor.formatOnSaveTimeout": 2000，默认 750ms 对某些大文件或远程开发环境太短
files.autoSave 和 formatOnSave 是两回事，别漏掉前者
files.autoSave 控制“什么时候保存”，editor.formatOnSave 控制“保存时要不要格式化”。如果 files.autoSave 是 "off"（默认值），那你必须手动按 Ctrl+S 才会走格式化流程；如果设成 "onFocusChange"，切出编辑器窗口时就自动保存+格式化。
- 两者必须同时开启才有效果：
"files.autoSave": "onFocusChange"+"editor.formatOnSave": true - 别混淆
files.autoSaveDelay和editor.formatOnSaveTimeout：前者是“延迟多少毫秒再保存”，后者是“格式化最多等多久” - 远程开发（如 WSL、Dev Container）中，
files.autoSave有时会被底层限制，此时建议改用afterDelay并设files.autoSaveDelay为1000
真正容易被忽略的点是：格式化行为受项目级配置（如 .prettierrc、.editorconfig、.vscode/settings.json）叠加影响，且工作区设置优先级高于用户设置。调试时别只盯自己电脑上的全局设置，先打开命令面板运行 Preferences: Open Workspace Settings (JSON)，确认当前生效的是哪一份。
