VSCode 设置同步依赖 GitHub 账户而非 Microsoft 账户，需授权 GitHub gist 权限；同步内容含设置、扩展、快捷键等，但自动过滤敏感字段（如 apiKey、token）；多设备同步需手动选择合并项，失败常见于 token 过期或网络拦截。
VSCode 同步设置依赖 GitHub 账户而非 Microsoft 账户
VSCode 的设置同步功能（Settings Sync）默认使用 GitHub 账户登录，不是 Microsoft 或 GitHub Copilot 账户。如果你用微软账号登录了 VSCode 却没开启同步，大概率是因为没绑定 GitHub —— 这是用户最常卡住的第一步。
- 打开 VSCode，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: Turn on Settings Sync并回车 - 系统会跳转到 GitHub 授权页，必须勾选
user:email和read:user权限（仅用于识别账户和同步配置，不涉及仓库操作） - 授权后，VSCode 自动上传当前配置（包括
settings.json、已安装扩展、键盘快捷键、代码片段、UI 布局等）到 GitHub Gist，生成一个私有syncgist
多台设备上启用同步时需手动触发拉取
新设备首次开启同步不会自动覆盖本地设置，而是进入「冲突选择」流程：VSCode 会列出远程与本地的差异项（比如某扩展在 A 机装了、B 机没装），你得主动勾选要同步的内容。
- 在第二台设备上执行
Preferences: Turn on Settings Sync，登录同一 GitHub 账户 - 弹出的对话框中，取消勾选
Extensions（如果你本地已有特定版本扩展，避免被降级）；但建议保留Settings、Keybindings、Snippets - 点击
Continue后，VSCode 会下载远程 gist 并合并——注意：它不会删除你本地未上传的扩展，也不会覆盖你手动改过的settings.json里未被同步的字段
同步失败常见原因和对应检查点
错误信息如 Failed to sync: Bad credentials 或 Unable to fetch sync data 多数和 token 权限或网络策略有关，而非账号密码问题。
- 检查 GitHub 的 Personal Access Token 是否过期：进入 GitHub Settings → Developer settings → Personal access tokens，确认 token 存在且权限包含
gist（Settings Sync 强制要求） - 企业网络或代理可能拦截 gist.github.com 请求，可临时切换网络测试；也可在 VSCode 设置中搜索
sync: gist，确认sync.gist值为空（非空表示被手动修改过，应保持默认） - 如果某台设备同步后扩展列表异常（比如变空），检查该设备是否启用了
extensions.autoUpdate：设为false可防止同步后自动升级引发兼容问题
敏感配置（如 API key、本地路径）不会被同步
VSCode 同步机制默认排除以下内容：所有以 http、https、ftp 开头的字符串值；含 key、token、password、secret 等关键词的配置项；以及 files.excludes 中定义的路径模式。这是硬编码过滤逻辑，无法关闭。
- 例如你在
settings.json中写了"myExtension.apiKey": "abc123"，这个字段根本不会上传到 gist - 但像
"editor.fontSize": 14或"workbench.colorTheme": "One Dark Pro"这类通用设置会完整同步 - 若需跨设备共享敏感配置，应改用环境变量（如
process.env.MY_API_KEY）或独立的.env文件 + 扩展（如dotenv插件），不要塞进全局 settings
{
"editor.fontSize": 14,
"workbench.colorTheme": "One Dark Pro",
"myExtension.apiKey": "abc123"
}
同步机制对字段级别的过滤是静默的，不报错也不提示。如果你发现某个自定义配置没同步过去，先查它是不是触发了敏感词过滤规则。 
