新成员 clone 项目后打开 VSCode 即可获得统一格式化、插件推荐、调试配置和代码检查，关键在于将 .vscode/settings.json（显式配置 formatOnSave、defaultFormatter 等）、.vscode/extensions.json（正确 Marketplace ID 数组）、.editorconfig（含 root = true）及 team.code-workspace 文件纳入 Git，并确保工作区被信任。
新成员 clone 项目后，打开 VSCode 就能自动获得统一格式化、必装插件、调试配置和代码检查——这事完全能做到，关键不是“一键点击”，而是把配置提前固化进项目目录里，并确保它们按正确优先级生效。
确保 .vscode/settings.json 被 Git 跟踪且不被用户设置覆盖
很多人把 settings.json 放进 .vscode/ 却发现新成员打开没反应，根本原因是 VSCode 的设置优先级：用户级 > 工作区级。如果成员本地设置了 "editor.tabSize": 4，那项目里的 "editor.tabSize": 2 就不会生效。
- 必须在
.vscode/settings.json中显式写出所有关键项，不能依赖继承，例如："editor.formatOnSave": true、"editor.defaultFormatter": "esbenp.prettier-vscode"、"files.trimTrailingWhitespace": true - 禁用可能冲突的全局行为：比如把
"editor.detectIndentation"设为false，否则 VSCode 会读取文件已有缩进而忽略.editorconfig - 提交前用 VSCode 的「设置」UI 打开右上角「打开设置(JSON)」，确认左侧显示的是「工作区」标签页，再复制内容到项目文件中，避免误粘贴用户设置
用 .vscode/extensions.json 触发插件推荐而非强制安装
VSCode 不支持“静默安装插件”，但 extensions.json 能让新成员一打开项目就看到带「Install All」按钮的推荐栏——前提是格式严格正确，且插件 ID 准确。
- 插件 ID 必须是完整 Marketplace ID，比如 Volar 是
"johnsoncodehk.volar"（不是volar或旧版vue.volar），TypeScript Vue 插件已合并进 Volar，别重复加 - 写法必须是数组形式：
{"recommendations": ["johnsoncodehk.volar", "dbaeumer.vscode-eslint"]}，漏掉recommendations字段或写成extensions都无效 - 如果团队用 Dev Containers，
extensions.json应放在.devcontainer/下，而不是项目根目录的.vscode/，否则容器内不会触发推荐
.editorconfig 生效失败的三个硬性条件
这个文件常被当成“摆设”，其实它只在三个条件同时满足时才真正起作用：插件已启用 + 根目录有 root = true + 文件路径匹配规则。缺一不可。
- 必须在
.editorconfig第一行写root = true，否则 VSCode 可能向上查找父目录的同名文件并中途停止 - 确认已启用
EditorConfig for VS Code插件（ID:editorconfig.editorconfig），macOS VSCode 1.85+ 内置，但 Windows/Linux 仍需手动安装 - 验证是否生效：打开一个
.ts文件，右下角状态栏应显示缩进值（如2 spaces）和换行符（LF），若显示auto或与配置不符，说明未命中规则
用 team.code-workspace 统一多文件夹项目的入口
单 settings.json 只能管一个文件夹；如果是 monorepo（如 packages/ui 和 packages/api），必须用 .code-workspace 文件才能把所有配置收束到一个入口。
- 创建方式不是手动写 JSON，而是：菜单栏 → 「文件」→ 「将工作区另存为…」→ 保存为
team.code-workspace，再编辑该文件，在settings字段里填入和.vscode/settings.json相同的内容 -
folders字段要写相对路径，如{"path": "packages/ui"}，不能写绝对路径或./packages/ui - 新成员必须双击打开
team.code-workspace文件（而非直接打开文件夹），否则settings和extensions.recommendations都不会加载
最易被忽略的点是：VSCode 的「工作区信任」机制默认关闭未信任文件夹的自动格式化和插件运行。新成员首次打开项目时，右下角会出现黄色横幅提示「此工作区未受信任」，必须点「Enter Workspace Trust」并勾选全部选项，否则 formatOnSave 和 ESLint 都不会触发——这个动作没有替代方案，也不能跳过。
