VSCode格式化失效需同时满足扩展安装、语言识别正确、格式化器配置匹配三条件；自动保存格式化须配合语言专属defaultFormatter设置，并通过项目级配置文件统一团队规范。
为什么装了 Prettier / Black 却按 Shift+Alt+F 没反应？
VSCode 本身不格式化代码，它只是个“调度员”——得有扩展装对、语言识别对、格式化器配对成功，三者缺一不可。常见现象是：打开一个 .py 文件，按快捷键没反应，状态栏右下角却显示 Plain Text；或者明明装了 esbenp.prettier-vscode，但 .ts 文件里就是不触发。
- 点击右下角语言模式，手动切换为
Python或TypeScript，再试一次Shift+Alt+F - 在命令面板（
Ctrl+Shift+P）输入Format Document With，看下拉列表是否出现你装的格式化器；若为空，说明该语言未被扩展支持或扩展未启用 - Python 用户尤其注意：
ms-python.python扩展必须启用，且 Python 解释器已正确选中（右下角显示带路径的 Python 版本），否则black就调不动
怎么让保存时自动格式化真正生效，而不是“看起来开了”？
"editor.formatOnSave": true 是全局开关，但它只负责“喊一声”，真正干活的是每个语言专属的默认格式化器。很多人开了这个，却没配 "[javascript]" 这类语言块，结果 JS 文件格式化了，TS 文件却静默失败。
- 必须配合语言专属设置，例如：
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 不建议在用户设置里全局开
formatOnSave，而应在项目根目录的.vscode/settings.json中配置，避免不同项目风格冲突 - 若某类文件（如
.vue）仍不格式化，检查是否漏了对应语言块："[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
团队协作时，为什么你格式化完，别人 git diff 一堆空格和换行？
因为 VSCode 的 settings.json 只作用于你本地。别人没装 Prettier、没开 formatOnSave、甚至用的是 WebStorm，所有这些都会让格式“各过各的”。
- 把规则写进项目级配置文件，才是唯一可靠方式：
.prettierrc（Prettier）、pyproject.toml（Black）、.editorconfig（缩进/换行等基础层） -
.editorconfig是跨编辑器的底线保障，但不能替代.prettierrc；两者要共存，不要试图用其中一个覆盖另一个 - 在
prettier扩展设置中开启"prettier.requireConfig": true，强制它只在有.prettierrc时才工作，避免“本地随意格式化污染仓库”
同时用 ESLint 和 Prettier，为什么会互相打架？
典型表现是：保存后引号从单引号变双引号，再保存又变回来；或者控制台报错 Conflict with eslint。根本原因是 ESLint 自己也在“管格式”，而 Prettier 也想管，谁也不让谁。
- 在
.eslintrc.js中显式关掉所有格式类规则："rules": { "quotes": "off", "semi": "off", "comma-dangle": "off", "indent": "off" } - 或更稳妥地，直接继承
eslint-config-prettier，它就是干这事的 - 如果希望保存时既格式化又修复 ESLint 问题，用
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，但前提是 ESLint 规则里已禁用格式项，否则仍会冲突
真正难的不是配几个 JSON 字段，而是搞清谁在什么时候、以什么优先级介入格式化流程。VSCode 不会替你做判断，它只忠实地执行你写的规则和你选的工具。
