VSCode依赖外部格式化器，需按语言选主流工具：JS/TS用Prettier+ESLint、Python用Black或Ruff、Go用gofmt、C/C++用clang-format、Markdown用Prettier；配置时应优先项目级设置，明确分工并避免冲突。
VSCode本身不内置代码格式化逻辑，它依赖外部格式化器（如 Prettier、ESLint、Black、clang-format 等）来实际执行格式化。选择和配置的关键在于：**语言 + 项目规范 + 团队约定**，而不是“哪个最好”。
按语言选主流格式化器
不同语言生态有公认的事实标准，优先跟随社区惯例：
- JavaScript/TypeScript：Prettier（专注风格统一） + ESLint（兼顾代码质量），二者可协同（Prettier 关闭 ESLint 中与格式冲突的规则）
-
Python：Black（“无需配置”哲学）或 autopep8 / yapf（更灵活但需调参）；若用 Ruff，它已集成格式化能力（
ruff format） -
Go：官方
gofmt或增强版goimports（自动管理 import） - C/C++：clang-format（配合 .clang-format 配置文件）
- Markdown：Prettier（支持 frontmatter、列表缩进等）或 Remark（更语义化）
在 VSCode 中启用并设为默认
安装对应扩展（如 “Prettier – Code formatter”、“ESLint”、“Black Formatter”），然后在设置中指定默认格式化器：
- 打开设置（
Ctrl+,或Cmd+,），搜索 “default formatter” - 找到 “Editor: Default Formatter”，点击下拉菜单，按语言选择（例如：TypeScript → “esbenp.prettier-vscode”）
- 也可在工作区根目录的
.vscode/settings.json中精确控制：
{
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
"[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }
}
避免格式化冲突：Prettier + ESLint 的典型协作
两者都可能改代码，不协调会导致保存时反复“打架”。推荐做法：
- 用 Prettier 主导格式（缩进、引号、分号、换行等）
- 用 ESLint 主管逻辑（未使用变量、潜在 bug、最佳实践）
- 安装
eslint-config-prettier插件，在 ESLint 配置中禁用所有与 Prettier 重叠的规则 - VSCode 中关闭 ESLint 的自动格式化（
"eslint.format.enable": false），只让它做检查和修复建议
项目级配置比全局设置更重要
团队协作时，把格式规则固化在项目里，而非靠个人设置：
- 在项目根目录放配置文件：如
.prettierrc、.eslintrc.cjs、pyproject.toml（含 [tool.black]） - 确保
.vscode/settings.json启用"editor.formatOnSave": true，并设对默认格式化器 - 加
.editorconfig作为基础层（处理缩进大小、换行符等编辑器无关规则） - 提交前用 husky + lint-staged 拦截未格式化代码（可选但强烈推荐）
基本上就这些。不复杂但容易忽略的是：别试图用一个工具解决所有问题，明确分工（谁管风格、谁管质量、谁管导入），再配好项目配置，格式化就能安静地为你服务。
