VS Code代码格式化依赖扩展和语言服务器，需安装对应扩展、开启editor.formatOnSave、确保格式化工具已安装并可调用；缺少任一条件将导致格式化失效。
VS Code 本身不自带代码格式化逻辑，所有格式化能力都来自扩展和语言服务器。配置是否生效，关键看三件事：有没有装对扩展、editor.formatOnSave 是否开启、对应语言的格式化工具（如 prettier、eslint、black）是否已安装且可被 VS Code 正确调用。
确认当前语言有可用的格式化提供者
VS Code 只会在检测到已启用的格式化扩展支持当前文件类型时，才激活格式化功能。比如打开一个 .js 文件，但没装 esbenp.prettier-vscode 或 dbaeumer.vscode-eslint，那按 Shift+Alt+F 会提示 “没有可用的格式化程序”。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Format Document With...，看下拉列表里有没有选项 - 如果没有，说明缺少对应语言的格式化扩展——JavaScript/TypeScript 常用
esbenp.prettier-vscode；Python 推荐ms-python.python（内置autopep8/black支持）；CSS/HTML 可靠esbenp.prettier-vscode - 扩展安装后，重启 VS Code 或重开文件，再试一次
Format Document With...
设置保存时自动格式化 + 自动修复问题
仅开启 editor.formatOnSave 只能格式化，不能修复 ESLint 或 Prettier 报出的具体问题（如多余分号、引号不一致）。要实现“保存即修复”，需额外配置 editor.codeActionsOnSave。
{
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true,
"source.fixAll.prettier": true,
"source.fixAll": true
},
"eslint.validate": ["javascript", "typescript", "vue"]
}
-
"source.fixAll"是兜底项，但部分语言服务器不响应它；优先显式写明eslint或prettier - 如果用了 ESLint，确保项目根目录有
.eslintrc.js或eslint.config.js，且 VS Code 能读到（不是只装了扩展但没配规则） - 某些扩展（如 Prettier）需在设置中指定默认格式化工具：
editor.defaultFormatter设为esbenp.prettier-vscode
避免 prettier 和 eslint 冲突的典型配置
当同时启用 ESLint 的 fixAll 和 Prettier 格式化，容易出现“保存后又被改回去”或报错“Conflict with eslint”。根本原因是两者规则重叠（如单双引号、结尾分号）。
- 不要让 ESLint 管格式：在
.eslintrc.js中禁用所有格式类规则，例如："quotes": "off"、"semi": "off"、"comma-dangle": "off" - 用
eslint-config-prettier一键关闭所有冲突规则：npm install --save-dev eslint-config-prettier
，然后在extends中加入"prettier" - Prettier 配置统一放在
.prettierrc（而非 VS Code 设置里），便于团队和 CI 一致
Python 自动修复常卡在 black / autopep8 不生效
Python 用户常遇到：点了格式化没反应，或 codeActionsOnSave 不触发 black。问题多出在 Python 扩展未识别到本地环境中的格式化工具。
- 确认已安装
black：pip install black
（推荐用项目虚拟环境安装，而非全局） - 在 VS Code 设置中搜索
python.formatting.provider，设为black - 检查
python.defaultInterpreterPath是否指向正确的 Python 解释器（尤其使用 conda 或 venv 时） - 若仍无效，打开命令面板运行
Python: Select Interpreter，手动选中含black的环境
真正卡住的地方往往不是配置项写错，而是格式化工具本身没被 VS Code 进程找到——它不会主动报错，只会静默跳过。验证方式很简单：打开终端，cd 到项目根目录，执行 npx prettier --write . 或 black .，如果终端能跑通，但 VS Code 不行，那一定是路径或解释器配置没对上。
