最可靠方式是显式创建并提交 .code-workspace 文件：在空窗口中执行“file > save workspace as…”保存为 team-workspace.code-workspace，手动编辑 json，folders 中使用相对于该文件的相对路径（如 "./services/auth-service"），配置共享 settings（如 editor.tabsize），避免绝对路径、环境变量或符号链接，并确保该文件纳入 git 版本控制。
直接用 .code-workspace 文件定义多个项目路径，并把该文件提交到 Git，团队成员打开它就能获得一致的目录结构、共享设置和调试配置——这是最可靠的方式，别依赖“拖文件夹进窗口”这种临时操作。
怎么生成可提交的 .code-workspace 文件
不要靠拖拽或命令行临时添加文件夹，那只会生成未保存的运行时状态，关掉就丢。必须显式创建并保存为文件：
- 在空 VSCode 窗口中，执行命令
File: Save Workspace As...，保存为team-workspace.code-workspace（后缀不能错） - 手动编辑该文件，在
"folders"数组里用相对路径写死各模块位置，比如"path": "./services/auth-service" - 确保所有路径都是相对于
.code-workspace文件所在目录的，否则别人 clone 后打开会报Folder does not exist - 别把
path写成绝对路径，也别用环境变量或符号链接——VSCode 不解析这些
settings 字段该放什么、不该放什么
工作区级 settings 是团队协同的关键，但容易误配：
- 适合放：统一的
editor.tabSize、files.exclude（如"**/node_modules": true）、eslint.enable这类影响所有根目录的行为 - 不适合放：语言专属配置（如
python.defaultInterpreterPath），它无法按文件夹区分，会导致冲突；这类应下沉到每个项目的.vscode/settings.json - 如果某个设置只对特定根目录生效（比如前端要 prettier，后端不用），就别放在这里——得靠文件夹级
.vscode/settings.json覆盖 - 注意：工作区
settings优先级高于用户设置，但低于单个文件夹里的.vscode/settings.json
为什么团队成员打开后看不到所有文件夹
常见现象是只加载了第一个文件夹，或者提示 “Invalid workspace configuration”：
- 检查 JSON 格式是否合法——少了个逗号、多了个逗号、引号不闭合，VSCode 不报错但静默失败
- 确认
"folders"是数组，不是对象；每个元素必须有"path"字段，"name"可选但建议加上，方便识别 - 路径存在但权限不足（尤其 Linux/macOS 下的 symlink 或 Docker volume 挂载点），VSCode 会跳过该条目且无提示
- 如果用了
"path": "../shared"这种跨父目录的写法，确保所有成员的克隆路径层级一致，否则相对路径失效
最易被忽略的一点：.code-workspace 文件本身必须纳入版本控制，且团队要约定好它的存放位置（比如项目根目录下），否则每个人各自保存一份，路径和设置很快就会不一致。
