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？
以下几类配置不会随账户同步，且极易引发“在我机器上能跑”问题：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
.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 同步范畴内
怎样让新电脑“直接运行”？关键动作只有三步
不是等同步完成就完事，而是要主动把运行上下文显式固化下来：
- 把
.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 有没有同步成功，而是你有没有把运行所需的全部上下文——路径、环境变量、二进制依赖、调试器配置——变成可复现、可审查、可版本化的显式声明。
