VSCode Settings Sync 功能已迁至 Microsoft 账户体系，旧版 GitHub Gist 同步被弃用；可启用微软云同步、回退 GitHub 兼容模式、手动导入导出 JSON 配置或直接编辑 settings.json 同步关键项。
如果您发现 VSCode 的 Settings Sync 功能界面消失、命令不可用或提示“已弃用”，这可能源于 Microsoft 对同步机制的结构性调整。自 2025 年中起，VSCode 官方已将原基于 GitHub Gist 的 Settings Sync（旧版插件及内置同步服务）逐步迁移至统一的云账户体系。以下是针对该变更的多种适配与恢复方案：
本文运行环境：MacBook Pro M3，macOS Sequoia。
一、启用 VSCode 内置的 Microsoft 账户同步
新版同步依赖 Microsoft 账户而非 GitHub，所有配置通过微软云服务加密托管，无需手动管理 token 或 gist。该方式为当前官方主推路径，支持全量同步且自动处理冲突。
1、打开 VSCode，按下 Cmd + Shift + P 调出命令面板。
2、输入并选择 Settings Sync: Turn On。
3、在身份验证弹窗中选择 Sign in with Microsoft，使用个人或工作 Microsoft 账户登录。
4、勾选需同步的项目：Settings、Extensions、Keybindings、Snippets、UI State。
5、点击 Turn On & Upload，等待状态栏右下角显示“Synced”图标。
二、回退使用 GitHub 账户的兼容模式
若团队仍依赖 GitHub Gist 历史快照或需与旧设备保持兼容，可强制启用 GitHub 同步通道。此模式绕过 Microsoft 账户强制策略，但需手动配置认证凭证。
1、在命令面板中执行 Preferences: Configure Runtime Arguments。
2、在打开的 argv.json 文件中添加以下行：
"sync.useGitHub": true
3、保存文件并重启 VSCode。
4、再次运行 Settings Sync: Turn On，此时将出现 GitHub 登录选项。
5、按提示生成 Personal Access Token（需勾选 gist 和 read:user 权限），粘贴后完成绑定。
三、手动导入导出配置实现离线同步
当网络受限或需完全规避云服务时，可通过本地 JSON 文件迁移核心配置。该方法不依赖任何账户，适用于高安全要求场景，且能精确控制同步粒度。
1、在源设备上执行命令面板指令：Developer: Export Settings。
2、选择导出范围（建议勾选 All Settings），保存为 settings-export-2025.json。
3、将该文件复制至目标设备的任意位置。
4、在目标设备 VSCode 中运行：Developer: Import Settings。
5、定位并选择该 JSON 文件，确认导入后重启编辑器。
四、通过 settings.json 手动同步关键项
部分配置项（如字体、缩进、自动保存）可直接提取为纯文本片段复用，避免同步服务失效导致的环境断裂。此法轻量、即时、无依赖，适合快速恢复基础偏好。
1、在源设备打开 VSCode 设置界面，点击右上角 ··· → Open Settings (JSON)。
2、复制以下区块内容（保留原始缩进与逗号）：
"editor.fontSize": 14, "files.autoSave": "onFocusChange", "workbench.colorTheme": "One Dark Pro"
3、在目标设备同路径的 settings.json 中粘贴至已有配置末尾（确保为合法 JSON 格式）。
4、保存文件，VSCode 将立即应用变更。
