VSCode的launch.json不随账户同步，因其属工作区级配置，需通过Git提交才能在新电脑复用；settings.json同步仅覆盖用户级设置，无法传递调试路径、环境变量等运行时依赖。

换台电脑后 VSCode 不能“直接运行”——settings.json 和插件列表同步了，不代表项目能立刻跑起来。真正卡住的从来不是配置文件，而是那些没被同步、也没被显式声明的运行时依赖。

为什么 settings.json 同步了，launch.json 还是报错？

launch.json 属于工作区级配置，不在 Settings Sync 的默认同步范围内。它只存在于项目根目录下的 .vscode/launch.json，而内置同步只管用户级（$HOME/.config/Code/User/）内容。

• 你改了调试器参数、加了 env 变量、指定了 runtimeExecutable 路径，这些全都不会上传到云端
• 即使你在新电脑上拉取了旧项目的完整代码，.vscode/launch.json 也得靠 Git 提交才能带过去——否则就是空文件夹
• 某些调试器（如 cppdbg、python）会根据当前系统自动补全路径字段，但跨平台时容易写死 Windows 风格路径，比如 "program": "C:\build\app.exe"，在 macOS 上直接炸

哪些运行配置必须手动处理，不能靠 Settings Sync？

以下几类配置不会随账户同步，且极易引发“在我机器上能跑”问题：

• .vscode/tasks.json：自定义构建命令，尤其含本地工具路径（如 "command": "C:\Program Files\CMake\bin\cmake.exe"）
• .vscode/extensions.json：推荐插件列表（仅提示安装，不自动装；且不保证版本一致）
• .vscode/settings.json：项目级覆盖项（例如 "editor.tabSize": 2），需和代码一起提交 Git
• 插件自身配置：像 prettier 的 .prettierrc、eslint 的 .eslintrc.js，这些根本不在 VSCode 同步范畴内

怎样让新电脑“直接运行”？关键动作只有三步

不是等同步完成就完事，而是要主动把运行上下文显式固化下来：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 把 .vscode/ 目录整个加入 Git：确保 launch.json、tasks.json、settings.json 都在版本控制中（注意排除 .vscode/workspaceStorage/）
• 用 code --list-extensions > extensions.txt 导出扩展清单，再在新机器执行 cat extensions.txt | xargs -L 1 code --install-extension ——比靠同步更可控
• 对跨平台敏感字段做条件化处理：比如在 launch.json 中用 ${env:HOME} 替代硬编码路径，或用 ${os} 变量分支（VSCode 1.85+ 支持）

同步失败时最该检查的不是插件，而是这几个地方

状态栏云图标变灰、插件没装、快捷键失效？别急着重装，先看这些：

• 执行 Sync: Show Summary，确认 Extensions 是否真被勾选——很多人只勾了 Settings，漏掉 Extensions，结果插件列表根本没上传
• 检查 settingsSync.ignoredSettings 是否误写了 extensions 或 debug.* 相关字段
• 打开开发者工具（Developer: Toggle Developer Tools），Console 里搜 sync，常见错误如 Failed to fetch from sync store 多因公司防火墙拦截了 vscode-sync.trafficmanager.net
• 新设备首次启动 VSCode 后，别马上点同步——等左下角扩展市场图标停止旋转（表示插件服务就绪），再触发 Sync: Trigger Sync

真正决定“能不能直接运行”的，从来不是 settings.json 有没有同步成功，而是你有没有把运行所需的全部上下文——路径、环境变量、二进制依赖、调试器配置——变成可复现、可审查、可版本化的显式声明。