vscode保存后怎么自动格式化

vscode开启“format on save”无反应，是因为未为对应语言设置editor.defaultformatter；必须在settings.json中按语言显式配置，如”[javascript]”: {“editor.defaultformatter”: “esbenp.prettier-vscode”}，全局配置无效。

为什么开了“Format On Save”却没反应？

VSCode 默认不格式化，不是开关没开，而是它根本不知道“该叫谁来干这事”。editor.formatOnSave 只是个触发器，真正干活的是你指定的格式化程序——没配 editor.defaultFormatter，哪怕装了 Prettier、Black 或 ESLint，保存时也完全静音。

常见错误现象：

• 右下角状态栏显示 “None”（而不是 “Prettier” 或 “Black”）
• 右键 → “Format Document With…” 列表为空或全是灰色
• 按 Ctrl+Shift+P 输入 “Format Document”，提示 “No formatter available”

实操建议：

• 先确认已安装对应扩展：如 JavaScript/typescript 装 esbenp.prettier-vscode，Python 装官方 Python 扩展（内置 Black 支持）或单独装 ms-python.black-formatter
• 必须为语言显式设置默认格式化器，例如在 settings.json 中加：

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

• 不要只写全局 editor.defaultFormatter，VSCode 会忽略它对特定语言的约束力；语言专属配置才真正生效

JavaScript/TypeScript 怎么让 ESLint 修复 + Prettier 格式化一起跑？

想保存时既修 semi、quotes，又调 Prettier 统一缩进和换行，得靠两层配合：ESLint 负责语义修复，Prettier 负责样式美化。顺序错了容易互相覆盖。

使用场景：

• 项目已有 .eslintrc.js，且用了 eslint-config-prettier 关闭冲突规则
• 不希望每次手动跑 npx eslint --fix 或 npx prettier --write

实操建议：

• 开启 ESLint 自动修复："eslint.run": "onSave" 和 "editor.codeActionsOnSave": { "source.fixAll.eslint": true }
• 确保 Prettier 是默认格式化器，且 editor.formatOnSave 为 true
• 关键细节：VSCode 默认先执行 codeActionsOnSave（即 ESLint 修复），再走 formatOnSave（Prettier 格式化）。这个顺序不能颠倒，否则 Prettier 可能抹掉 ESLint 刚加上的 return 或重命名

Python 用 Black 格式化，但保存后没变化？

Black 在 VSCode 中不是装上就自动接管的。Python 扩展本身支持多种格式器（autopep8、yapf、Black），但必须明确告诉编辑器：“这个项目，就用 Black”。

常见错误现象：

• 保存后缩进没变、括号没换行、字符串引号没统一
• Ctrl+Shift+P → “Format Document With…” 里选了 Black，但没勾“设为默认”
• 项目根目录有 pyproject.toml，但 VSCode 没读到（比如工作区没打开在项目根）

实操建议：

• 在项目级 .vscode/settings.json 中写：

  "[python]": { "editor.defaultFormatter": "ms-python.black-formatter", "editor.formatOnSave": true }

• 确保 Black 已通过 pip 安装在当前 Python 环境：pip install black
• 如果用 conda 或虚拟环境，务必在 VSCode 右下角选择正确的 Python 解释器（带 Black 的那个）

xml / Markdown / JSON 文件怎么启用保存自动格式化？

这些非编程语言文件的格式化，依赖专用扩展，且 VSCode 不会自动关联——即使你装了 XML Tools 或 Markdown All in One，也得手动绑定语言和格式化器。

使用场景：

• 编辑 package.xml、config.xml 时想自动缩进和换行
• 写 Markdown 时希望标题对齐、列表缩进统一
• 修改 tsconfig.json 后自动美化结构

实操建议：

• XML：装 DotJoshJohnson.xml，然后加配置：

  "[xml]": { "editor.defaultFormatter": "DotJoshJohnson.xml" }

• Markdown：推荐 yzane.markdown-pdf 不行，要用 vscode.markdown-language-features（VSCode 内置）或 bierner.markdown-preview-github-styles（仅预览），真正能格式化的其实是 esbenp.prettier-vscode（需在 .prettierrc 中启用 proseWrap: "always" 等）
• JSON：VSCode 内置格式器足够，直接设："[json]": { "editor.defaultFormatter": "vscode.json-language-features" }

配置这件事，从来不是“开个开关”就完事。最常被跳过的一步，是忘记为语言单独指定 editor.defaultFormatter ——它不像插件安装那样有视觉反馈，但缺了它，formatOnSave 就只是个摆设。