VS Code代码格式化需三者协同：安装对应语言的格式化扩展（如Prettier/ESLint）、配置workspace级默认格式化器并启用formatOnSave、禁用冲突规则（如eslint-config-prettier），同时提交.editorconfig和prettier.config.js至仓库以保障跨编辑器与团队一致性。
VS Code 本身不自带统一的代码格式化标准，真正起作用的是你装的扩展 + 对应语言的格式化工具 + 显式配置的保存行为。没配对这三者，Ctrl+S 不会自动格式化，团队风格也压根无法对齐。
必须安装对应语言的格式化扩展（比如 Prettier 或 ESLint）
VS Code 的「格式化」功能是插件驱动的。例如 JavaScript/TypeScript 项目，光靠内置的 JavaScript Language Features 做不了语义级重排（如箭头函数换行、对象属性排序），得靠 Prettier 或 ESLint 这类外部工具。
-
Prettier是“强约定”型：只管样式（缩进、引号、分号、换行），不管逻辑错误；适合快速统一视觉风格 -
ESLint + eslint-config-prettier是“混合型”：既能报错（如未定义变量），也能接管格式（需关掉 ESLint 自带的格式规则，避免和 Prettier 冲突） - Python 用
black或autopep8，Go 用gofmt，Rust 用rustfmt—— 工具必须和语言匹配，且已全局或本地安装（如npm install -D prettier或pip install black）
在 workspace 设置中明确指定默认格式化工具
VS Code 允许为每种语言设置专属格式化器，这个配置比用户级设置更优先，也更适合团队共享。别依赖“自动检测”，它经常选错。
- 打开项目根目录下的
.vscode/settings.json - 写入类似下面的内容（以 TypeScript 为例）：
{
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
},
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true
}
}
注意：esbenp.prettier-vscode 是 Prettier 官方扩展的 ID，不是包名；如果用 ESLint，ID 是 dbaeumer.vscode-eslint，且要额外加 "eslint.format.enable": true。
禁用冲突格式化规则，尤其是 ESLint 和 Prettier 同时存在时
两者都开启格式化，大概率导致保存时反复“打架”：Prettier 把逗号放到行尾，ESLint 又把它挪回去，最后卡死或报错 Failed to format document。
- 在
package.json的eslintConfig中加入"extends": ["eslint:recommended", "prettier"]（顺序不能反） - 确保安装了
eslint-config-prettier并验证它是否生效：npx eslint --print-config .eslintrc.js | grep -A5 "comma-dangle"，看到off才算关成功 - VS Code 设置里不要同时开
editor.formatOnSave和eslint.autoFixOnSave（后者已废弃），改用"eslint.codeAction.onSave.mode": "all"
团队同步的关键：把 .editorconfig 和 prettier.config.js 提交到仓库
仅靠 VS Code 设置无法跨编辑器生效。新人用 WebStorm 或 Vim 打开项目，照样格式混乱。真正的团队约束得靠可执行的配置文件。
-
.editorconfig管基础项：缩进大小、换行符、UTF-8 编码 —— 几乎所有编辑器都认它 -
prettier.config.js或.prettierrc管具体规则：比如semi: false、singleQuote: true，Prettier CLI 和编辑器插件都会读它 - 这些文件必须 提交到 Git，且路径在项目根目录；否则
prettier会退回到全局配置或默认值，团队就又脱节了
最容易被忽略的是：格式化工具的版本差异。Prettier 2.x 和 3.x 对 if 块的换行处理不同，团队成员本地装的版本不一致，git diff 就会疯狂变。建议用 package-lock.json 锁死，或统一通过 npx prettier 调用。
