vscode设置同步默认关闭，须手动启用并用microsoft账户登录授权；同步内容需主动勾选extensions等项，不包括工作区设置和本地路径类敏感配置。

VSCode 设置同步功能默认是关闭的，必须手动触发并完成账户授权才能真正生效；不登录、不勾选、不确认，就永远只是灰色图标。

Preferences: Turn on Settings Sync 命令点不动？先看这三件事

很多人按 Ctrl+Shift+P 输入后找不到或点了没反应，本质是卡在前置条件上：

• VSCode 版本必须 ≥ 1.84（Help → About 查版本，旧版即使登录也白搭）
• 必须用 Microsoft 账户（Outlook/Hotmail 或 Azure AD）登录——GitHub 账户在新版中已不被支持
• 不是“登录 VSCode”，而是专门执行 Preferences: Turn on Settings Sync 命令，否则账户状态和同步后端不联动

如果命令面板里搜不到该条目，大概率是版本太低或账户根本没登录（检查左下角用户图标是否显示邮箱）。

同步后插件没装上？检查 Extensions 是否真被纳入同步范围

官方同步机制只上传/下载扩展 ID 列表，不自动安装二进制包；且“Extensions”开关默认是开启的，但容易被误关或首次配置时漏选：

• 运行 Preferences: Configure Sync，确认 Extensions 复选框处于勾选状态
• 首次开启同步时弹出的「Choose what to sync」面板里，务必手动勾选 Extensions（它不会默认全选）
• 同步完成后，插件实际安装依赖 extensions.autoUpdate 和网络——若卡在 “Installing…”，手动打开扩展视图点刷新按钮即可

注意：settingsSync.ignoredExtensions 是个隐藏开关，一旦填了值（比如 ["ms-python.python"]），对应插件就彻底不同步，连启用状态都不会传。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

settings.json 同步后 Python 解释器路径报错？这些字段不该同步

全局 settings.json 里混着大量机器强依赖项，盲目同步会导致跨平台失效甚至扩展崩溃：

• python.defaultInterpreterPath：Windows 路径同步到 macOS 直接让 Python 扩展报错
• terminal.integrated.shell.*：Linux/macOS/Windows 的 shell 路径互不兼容
• files.associations 或 editor.fontFamily 若含本地字体名（如 "Fira Code Retina"），另一台电脑没装就回退成默认字体

解决办法只有两个：要么把这些字段加 // @sync false 注释（VSCode 会跳过），要么干脆挪到项目级 .vscode/settings.json ——后者本身就不会被同步，天然隔离。

同步图标显示 “Synced” 却没更新？别信状态栏，要看实际差量

右下角云图标变蓝 ≠ 配置已拉取完毕，它只表示同步通道已建立；真正的数据传输是异步、延迟、差量的：

• 改完 settings.json 后切到另一台设备，可能要等 10–30 秒才触发上传+下载，别立刻查
• 手动点图标选 Sync Now (Upload) 或 Sync Now (Download) 才能强制走一次完整流程
• 若长期不同步，打开开发者工具（Developer: Toggle Developer Tools），在 Console 里搜 sync，看有没有 Failed to fetch 或 Unauthorized 报错

最常被忽略的一点：企业网络或国内环境经常拦截 vscode-sync.trafficmanager.net，此时必须配代理或换网络，不是账号问题。