VSCode保存时代码无变化，根本原因是editor.formatOnSave启用后缺少三硬性依赖：未安装对应语言格式化扩展、项目根目录缺失配置文件、未在项目根文件夹下打开工作区。
VSCode 本身不执行代码风格检查，也不“强制”规范——它只转发请求给外部工具（如 ESLint、Prettier、Black）。所谓“自动化流转”，本质是：保存 → 触发格式化 → 同步调用 Linter 修复 → 应用结果。漏掉任一环，就会出现“保存了但没反应”或“波浪线还在”。
为什么保存后代码没变样？检查这三处硬性依赖
VSCode 的 editor.formatOnSave 不是魔法开关，它背后必须同时满足：
- 已安装对应语言的格式化扩展（如
esbenp.prettier-vscode），且未被禁用 - 项目根目录存在可识别的配置文件（
.prettierrc、.eslintrc.cjs或pyproject.toml中含[tool.black]） - VSCode 当前打开的是**项目根文件夹**（不是某个子目录），否则插件找不到
node_modules或venv
常见错误现象：Format Document 命令灰掉、右下角语言标识旁没有格式化器图标、保存后缩进/引号/分号毫无变化。此时先运行 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools，看 Console 是否报 Failed to load module 类错误。
ESLint + Prettier 共存时，source.fixAll.eslint 和 editor.formatOnSave 怎么配才不打架？
二者职责不同：ESLint 检查逻辑问题（如 no-unused-vars），Prettier 只管样式（空格、换行、引号）。冲突发生在它们都试图改同一处（比如引号类型）时。正确做法是让 ESLint “让位”：
- 在
.eslintrc.cjs的extends数组末尾加上"plugin:prettier/recommended"（不是prettier单独一项） - 在
settings.json中禁用 ESLint 的格式类修复："editor.codeActionsOnSave": { "source.fixAll.eslint": true }—— 这句只修 ESLint 能自动修的逻辑问题，不碰格式 - 确保
"editor.defaultFormatter"明确设为"esbenp.prettier-vscode"，而非留空或设成 ESLint 插件
验证是否成功：改一行用双引号的字符串，保存后只触发一次格式化，且无红色波浪线提示 conflicting rule。
Shift+Alt+F 失效？优先排查语言模式和 formatter 绑定
这个快捷键实际调用的是当前文档语言模式（language mode）绑定的 formatter。失效常见于：
- 右下角显示的语言是
Plain Text而非JavaScript或Python（点击切换） - 该语言未设置默认 formatter，例如 Python 文件没装
ms-python.black-formatter，又没在settings.json里写"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 项目级
.vscode/settings.json覆盖了用户级设置，但里面漏写了语言专属配置
快速诊断：按 Ctrl+Shift+P → 输入 Format Document With... → 看列表中是否有可用选项。若为空，说明当前语言没注册 formatter。
团队协作时，.editorconfig 和 .vscode/settings.json 该信谁？
.editorconfig 是跨编辑器通用层（WebStorm、Vim、VSCode 都认），控制缩进类型、大小、换行符等基础项；.vscode/settings.json 是 VSCode 专属层，决定用哪个 formatter、是否保存时触发。二者不冲突，但优先级不同：
-
.editorconfig中的indent_style和indent_size会覆盖settings.json里的editor.tabSize和editor.insertSpaces -
settings.json里的editor.formatOnSave仍生效，但 formatter 输出会尊重.editorconfig的缩进约定 - 关键点：
.editorconfig必须放在项目根目录，且文件首行需有root = true，否则子目录下可能被忽略
容易被忽略的地方：很多人把 .editorconfig 放在 src/ 下，以为能管整个项目——其实它只影响自身及子目录，根目录没它，VSCode 就按用户全局设置走，团队成员之间立刻不一致。
