VSCode保存时自动格式化不生效需检查三处：未启用"editor.formatOnSave": true；缺少对应语言格式化工具或未设为默认formatter；相关扩展自身禁用了保存格式化。
VSCode 保存时自动格式化不生效？检查这三处配置
默认情况下 VSCode 不会自动格式化代码，必须显式启用并配对语言支持。常见现象是按 Shift+Alt+F 无反应、保存后缩进/空格没变化，大概率是以下任一环节缺失：
-
"editor.formatOnSave": true未在设置中开启（用户或工作区 settings.json） - 当前文件类型（如
.py、.ts）没有对应格式化工具（如python扩展未装或未设为默认 formatter） - 扩展自身禁用了保存时格式化（例如 Prettier 扩展的
prettier.enable关闭，或 ESLint 扩展的eslint.format.enable为false）
不同语言怎么配默认 formatter？以 Python 和 TypeScript 为例
VSCode 不自带语言格式器，需靠扩展提供实现。关键不是“装插件”，而是“指定谁来格式”：
- Python：装好
ms-python.python后，在设置里搜default formatter，找到Python › Formatting: Provider，选autopep8/black/yapf（推荐black，零配置） - TypeScript/JavaScript：装
esbenp.prettier-vscode，然后设置Editor › Default Formatter为esbenp.prettier-vscode；若同时用 ESLint，需关掉eslint.format.enable，否则两者冲突 - 注意：每个语言可单独配置，路径为
settings.json中的[javascript]、[python]等语言专属块，避免全局污染
Shift+Alt+F 对齐失效？可能是缩进或换行符惹的祸
手动触发格式化失败，常因编辑器底层状态与格式器预期不一致：
- 文件末尾有不可见的
\r\n（Windows）混入\n（Unix），导致某些 formatter（如prettier）拒绝处理——用右下角状态栏点击CRLF切成LF再试 - 当前文件未被识别为对应语言（右下角显示
Plain Text），点它手动选成Python或TypeScript - 缩进设置与 formatter 冲突：比如
editor.tabSize设为4，但black强制用4，而prettier默认2；建议统一设为2，并在prettier.config.js显式写tabWidth: 2
格式化后括号/运算符没对齐？那是 formatter 的能力边界
VSCode 的「格式化」本质是调用外部工具（如 prettier、black、clang-format），它们设计哲学不同：
-
prettier主打“不妥协的统一风格”，不支持函数参数跨行对齐（如每个参数独占一行并垂直对齐），这是故意为之 -
black同样禁止手动调整换行逻辑，但支持--line-length控制单行宽度，间接影响是否换行 - 真要强制对齐（如 JSON key 对齐、SQL 字段列对齐），得用专门扩展如
rewrap或aligner，它们不属于「格式化」范畴，而是「文本对齐」操作
别指望一个配置开关解决所有对齐需求——格式器管结构，对齐器管视觉，二者定位不同，混用反而容易出错。
