必须为每种语言单独配置[language-id]块，全局设置editor.defaultformatter无效；语言id须与右下角显示或“inspect editor tokens and scopes”中一致，格式化器id必须与marketplace完全匹配，且需启用editor.formatonsave:true并确保项目存在对应配置文件（如.prettierrc）。
必须为每种语言单独配 [language-id] 块，全局改 editor.defaultFormatter 没用。
确认语言 ID 是否匹配当前文件
VS Code 的语言特定设置靠方括号里的 ID 触发，不是文件后缀，也不是你“以为”的名字。右下角状态栏点语言名，或按 Ctrl+Shift+P → 输入 Change Language Mode 查看真实 ID。
-
typescriptreact和typescript是两个不同 ID，得分别配"[typescriptreact]"和"[typescript]" -
javascript不等于javascriptreact，后者常见于.jsx文件 -
python是标准 ID；py或Python（首字母大写）都无效 - Markdown 对应
markdown，不是md
格式化器 ID 必须和扩展 marketplace 完全一致
插件 ID 不是包名、不是显示名、不是作者名拼接，而是扩展在 VS Code Marketplace 页面 URL 末尾那一串，比如 esbenp.prettier-vscode —— 少一个点、多一个连字符、大小写错，都会静默失效。
- Prettier 官方扩展：ID 是
esbenp.prettier-vscode（不是prettier，也不是prettier-vscode） - ESLint 扩展：ID 是
dbaeumer.vscode-eslint，且需额外启用eslint.format.enable - C/C++ 自带 clang-format：不用装额外插件，但必须确保已安装
ms-vscode.cpptools - Black for Python：ID 是
ms-python.black-formatter（注意不是ms-python.python）
格式化不生效？检查这三处覆盖关系
VS Code 设置有四层优先级：命令行 > 工作区（.vscode/settings.json） > 用户（settings.json） > 默认。常被忽略的是工作区配置会直接盖掉用户级设置。
- 打开当前项目根目录的
.vscode/settings.json，搜formatOnSave或defaultFormatter，看有没有冲突项 -
"editor.formatOnSave": true必须显式设为true，默认是false - 某些格式化器（如 Prettier）要求项目根目录存在
.prettierrc或prettier.config.js才真正执行，否则跳过无提示 - C/C++ 项目若用 clang-format，
clang-format.style设为file时，必须确保.clang-format文件存在且路径可读
别依赖“自动检测”，手动指定才可靠
VS Code 的“自动检测格式化器”逻辑很弱，尤其在多插件共存时（比如同时装了 Prettier 和 ESLint），它可能随机选一个，或者 fallback 到内置格式器——后者对 TypeScript 几乎不处理语义换行。
- 前端项目建议统一用
"[javascript]"/"[typescript]"/"[html]"/"[css]"分别绑定esbenp.prettier-vscode - Python 项目推荐
"[python]": {"editor.defaultFormatter": "ms-python.black-formatter"}，再加"black-formatter.args": ["--line-length=88"] - 避免在用户级
settings.json里写通用规则，比如"editor.tabSize": 2，这种会被语言块覆盖，但容易让人误判原因
最容易被忽略的其实是语言 ID 和格式化器 ID 的拼写一致性——它们不是“大概对就行”，而是字符串完全匹配才能触发。哪怕只是多一个空格、少一个连字符，VS Code 都不会报错，只会安静地放弃格式化。
