插件没同步过来需检查extensions同步开关是否勾选及merge/replace选择:merge保留本地插件并叠加云端列表,replace则清空本地仅装云端清单;同步后大插件常卡在installing…状态,需手动刷新扩展面板触发安装。

插件没同步过来?检查 Extensions 同步开关和 Merge/Replace 选择
Settings Sync 默认不上传或下载插件列表,即使你登录了 GitHub 或 Microsoft 账户,Extensions 必须手动勾选。不点开 Settings Sync: Show Synced Data 确认复选框已打勾,新设备上就只会看到空荡荡的扩展面板。
首次开启同步时弹出的 Merge 或 Replace 提示不能跳过:
- Merge:保留本地已装插件,再叠加云端列表(安全,推荐)
- Replace:清空本地插件,只装云端清单(风险高,误选会丢掉一半插件)
同步完成后,ms-python.python 这类大体积插件常卡在 Installing… 状态——得手动打开扩展面板,点右上角刷新按钮触发实际安装。
中文界面切不成功?只认 zh-cn,且必须重启而非重载
Configure Display Language 命令下拉列表里,只有 zh-cn(全小写 + 连字符)能生效;zh-CN、zh_CN、Chinese (Simplified) 全部被忽略,重启后仍是英文。
安装语言包只是第一步,关键动作是执行该命令并选对值:
- 必须通过命令面板(Ctrl+Shift+P)输入 Configure Display Language,不能靠搜索匹配,要手动滚动找到 zh-cn
- 点击 Restart 按钮,不是 Reload Window —— 后者不重新初始化语言环境,locale.json 不加载
- Windows 用户需检查任务管理器中是否残留 Code.exe,macOS 用户要确认活动监视器里 Code 和 Code Helper 进程已全部退出
settings.json 里哪些路径字段会被静默过滤?
VSCode 同步时会跳过含机器依赖的绝对路径字段,不报错也不提示,导致配置在另一台设备上“看起来正常,实则失效”。典型被过滤项包括:python.defaultInterpreterPath、terminal.integrated.profiles.windows、http.proxy、telemetry.enableTelemetry。
想让某行配置参与同步,又怕路径冲突?加注释控制:"python.defaultInterpreterPath":"/usr/local/bin/python3",// @sync false
工作区级配置(.vscode/settings.json)天然不同步,这是设计使然,避免项目设置污染全局环境。
同步状态栏显示 “Synced” 就代表一切 OK 吗?
左下角灰色云图标 ≠ 启用成功;显示 Synced 只代表最后一次上传/下载动作完成,不代表当前配置和远端一致。比如你改了 keybindings.json 却没手动运行 Sync: Upload Settings,新设备就永远用不上新快捷键。
每次修改设置、装/卸插件、更新代码片段后,都必须手动运行:
- 原设备:Sync: Upload Settings(新版 Settings Sync 是 Settings Sync: Upload)
- 新设备:Sync: Download Settings(新版是 Settings Sync: Download)
没有后台监听,没有实时推送,也没有自动 diff —— 它只管你按下的那一下。











