团队协作配置须分离可共享项并验证依赖：导出keybindings.json仅取用户自定义部分，通过命令面板打开唯一纯净入口；检查when条件、跨平台键名、扩展依赖；settings.json需清理绝对路径与敏感字段；extensions.txt单独导出安装；Settings Sync不适合作为团队标准化主方案。
团队协作配置不能靠手动复制整个 User 目录，必须分离出可共享的配置项，并验证上下文依赖是否成立。
导出 keybindings.json 时只取用户自定义部分
直接打开命令面板（Ctrl+Shift+P），输入并选择 Preferences: Open Keyboard Shortcuts (JSON) —— 这是唯一能拿到干净、无平台默认值的入口。文件内容必须是合法 JSON 数组，例如：
[{"key":"ctrl+shift+l","command":"editor.action.formatDocument","when":"editorTextFocus"}]
若看到空数组 []，说明当前无自定义快捷键；别从设置 UI 右键“导出”（该功能已移除），也别去文件系统硬翻 %APPDATA%CodeUser 目录——那会混入 settings.json 或缓存文件，导致导入后冲突。
- 检查
when字段：比如"when":"gitlens:fileBlameActive"依赖 GitLens 扩展，没装就永远不触发 - 跨平台键名要显式区分：
ctrl在 macOS 上无效，得写两套：{"key":"cmd+shift+l","when":"isMac"}和{"key":"ctrl+shift+l","when":"!isMac"} - 别用
editor.action.formatDocument这类需扩展支持的命令，除非团队统一安装 Prettier/ESLint
导入 settings.json 前先清理绝对路径和敏感字段
settings.json 里藏了不少机器专属配置，比如 "python.defaultInterpreterPath"、"terminal.integrated.env.LINUX" 或 "files.exclude" 里的项目绝对路径。这些一旦同步到其他设备，轻则失效，重则报错或覆盖本地配置。
- 导出前用文本编辑器搜索并删掉所有含
:/、C:\、/Users/、/home/的行 - 禁用或删除涉及代理、凭据、环境变量的字段，如
http.proxy、git.postCommitCommand - 导入时确保 VSCode 已完全退出（Windows 任务管理器里确认没有
Code Helper进程） - 覆盖前删掉原
settings.json，别用编辑器直接保存——BOM 或 CRLF 换行符会导致 VSCode 静默回退到默认值
扩展列表必须单独导出 + 批量安装，不能复制 extensions 目录
VSCode 不允许直接拷贝 extensions 文件夹迁移插件：路径硬编码、二进制兼容性、激活状态丢失都会导致启动失败或功能异常。
- 导出命令：
code --list-extensions --show-versions > extensions.txt（保留版本号便于复现环境） - Linux/macOS 导入：
cat extensions.txt | xargs -L 1 code --install-extension - Windows PowerShell 导入：
Get-Content extensions.txt | ForEach-Object { code --install-extension $_ } - 安装后重启 VSCode，再检查
Developer: Show Running Extensions确认全部激活成功
Settings Sync 不适合团队标准化，但可作辅助通道
Settings Sync 本质是个人账号绑定的云同步服务，它不处理工作区设置、跳过含路径/敏感字段的配置、且无法锁定插件版本。团队用它，等于把配置控制权交给 GitHub 登录态和网络稳定性。
- 它同步的是“最终生效值”，不是你写的原始
settings.json—— 比如"files.exclude"被合并后可能面目全非 - 冲突时采用“最后写入者胜出”，没人审核变更内容，容易埋下协作隐患
- 如果真要用，务必在
settings.json中加"sync.ignoredSettings": ["python.defaultInterpreterPath"]显式排除不可迁移项 - 真正可靠的团队方案是：Git 管理
settings.json+keybindings.json+extensions.txt，配合 CI 验证格式与字段合法性
最常被忽略的一点：快捷键和设置生效，不取决于“文件是否存在”，而取决于 when 条件能否满足、扩展是否已启用、以及目标机器是否具备对应上下文（比如 notebookEditorFocused 需 Jupyter 扩展，而该扩展又依赖 Python 环境）。测试时别只按按键看有没有弹窗，要实际执行一次命令，观察结果是否符合预期。
