VSCode格式化失效主因是未配置默认格式化器或扩展冲突；需通过“Format Document With…”设置默认工具，检查语言模式、扩展启用状态及配置优先级（如Prettier与ESLint规则冲突），并确保Python等语言的专用路径和文件关联正确。
格式化快捷键没反应？先确认默认格式化工具
VSCode 本身不自带代码格式化逻辑，所有格式化行为都依赖已安装的格式化扩展（如 Prettier、ESLint、Python Extension 自带的 autopep8 或 black）。按 Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）无响应，大概率是没设好默认格式化程序。
操作步骤：
- 打开命令面板（
Ctrl+Shift+P），输入Format Document With...，回车 - 选择「Configure Default Formatter」，再选你期望的扩展（例如
esbenp.prettier-vscode） - 若列表为空，说明对应语言的格式化扩展未安装或未启用
注意：不同语言需单独配置。比如 JavaScript 和 TypeScript 默认格式化器可以不同，settings.json 中会看到类似 "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } 的条目。
格式化后缩进/引号/分号全乱了？检查配置冲突
常见现象：保存时自动格式化，但结果和预期相反——比如把单引号转双引号、加了不必要的分号、缩进变成 4 空格（而项目要求 2 空格）。这通常是 Prettier 配置与 ESLint 规则、或编辑器内置设置打架导致的。
关键排查点：
-
editor.tabSize和editor.insertSpaces是编辑器级设置，优先级低于格式化扩展；但若格式化工具（如prettier）没显式指定tabWidth或useTabs，它会 fallback 到这些值 -
prettier.config.js或.prettierrc中的semi: false可能被eslint-config-prettier关闭，但若 ESLint 本身启用了semi规则且配置为"fix"，就会覆盖 Prettier 行为 - VSCode 设置里开启
editor.formatOnSave后，如果同时开了editor.codeActionsOnSave并启用了source.fixAll.eslint，就可能触发两次修复，顺序错乱
建议统一入口：只让 Prettier 负责格式（空格、缩进、换行），ESLint 只做 lint + fix 非格式类问题（如未使用变量、函数命名），并在 settings.json 中禁用 ESLint 的自动格式动作：
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.codeActionsOnSave": {
"source.fixAll.eslint": false
}
}
Python 格式化不生效？black 和 autopep8 切换容易漏配
Python 扩展（ms-python.python）默认用 autopep8，但很多团队强制用 black。装了 black 插件（如 ms-python.black-formatter）却没生效，往往卡在三个地方：
- 没在 Python 扩展设置里切换：打开设置搜
python.defaultFormatter，选black（不是autopep8或yapf） -
black命令未加入$PATH，或 VSCode 没读到正确环境（尤其用 conda/poetry/virtualenv 时）；可在设置里手动填路径，如"python.formatting.blackPath": "./venv/bin/black" -
black默认不处理.pyi文件，也不格式化字符串中的表达式（如 f-string 内容），这不是 bug，是设计如此
验证是否调用成功：打开命令面板 → Python: Format Document，看右下角状态栏是否短暂显示 Formatting with black。没有？说明没走通。
格式化只对部分文件生效？语言模式和文件关联被忽略
新建一个 .js 文件，写完保存，发现没格式化——很可能当前文件的语言模式不是 javascript。VSCode 右下角会显示当前语言（如 Plain Text），点击它可手动切换。
更隐蔽的问题是文件关联被覆盖。比如你用 vue 扩展，它会把 .vue 文件的 <script> 区域识别为 javascript，但如果 vetur 已禁用、volar 又没配好 typescript.javascript.preferences.quoteStyle，script 标签内就不会被格式化。
检查方法：
- 打开任意文件，按
Ctrl+Shift+P→ 输入Change Language Mode，确认显示的是目标语言（如JavaScript React而非JavaScript） - 在
settings.json中检查是否有误写的文件关联，例如："files.associations": { "*.js": "typescript" }会导致 JS 文件被 TS 格式化器处理，而你实际装的是 Prettier for JS - Vue/Svelte/TSX 等复合文件，格式化依赖插件对嵌入语言块的支持，不能只靠全局默认格式化器
最麻烦的情况是多根工作区里，不同文件夹有独立 .prettierrc，但 VSCode 没检测到层级变化——这时候删掉 .vscode/settings.json 里的缓存字段，重启窗口更可靠。
