settings sync插件需手动从vs code扩展市场安装，搜索“settings sync”（作者shan khan），安装后重启vs code，再通过命令面板执行sync: update/upload settings触发token输入，github token须勾选gist权限，上传后生成唯一gist id需单独保存。
Settings Sync插件在哪安装
它不在 VS Code 官方同步功能里，也不是内置插件，必须手动从扩展市场安装。VS Code 1.66+ 版本已自带「设置同步」（Settings Sync via Microsoft Account），但社区版 Settings Sync 插件仍被广泛使用，尤其在需要 Gist 或 Gitee 同步的场景下。
直接在 VS Code 左侧扩展图标（或快捷键 Ctrl+Shift+X / Cmd+Shift+X）中搜索：Settings Sync —— 注意作者是 Shan Khan，图标为蓝色齿轮+云，不要选错名字相似的其他插件（比如 Sync Settings 或 Code Settings Sync）。
- 安装后必须重启 VS Code 才能激活命令（
Shift+Alt+U/Shift+Alt+D才可用） - 如果安装后命令面板搜不到
sync相关选项，先检查是否重启；再确认插件状态为「已启用」而非「已禁用」 - Mac 用户注意：快捷键中的
Alt实际对应的是Option键，不是Command
为什么装完不能立刻用 token
插件安装只是第一步，Settings Sync 不会自动弹出登录或配置界面。它依赖你主动触发上传或下载动作，才会引导输入 token —— 这是设计使然，不是 bug。
常见错误现象：
- 按 Shift+Alt+U 没反应
- 命令面板输入 sync 后只有模糊匹配、没有 Update/Upload Settings
- 插件已安装但右下角无同步图标
- 确保当前有至少一个文件或文件夹在工作区中打开（空窗口下部分版本不响应快捷键）
- 若仍无效，手动调出命令面板：
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Sync: Update / Upload Settings并回车 - 此时才会弹出输入框，要求填入 GitHub/Gitee 的 personal access token
GitHub token 必须勾选 gist 权限
token 权限不对是同步失败最常被忽略的原因。GitHub 的 Personal Access Token 页面里，gist 权限必须显式勾选，否则上传时会报错：403 Forbidden: gist access denied 或静默失败（无提示但 syncSummary.txt 不生成）。
- 路径：GitHub →
Your profile→Settings→Developer settings→Personal access tokens→Generate new token - Description 填个有意义的名字（如
vscode-sync），便于后续管理 - 只勾选
gist即可，无需repo或user等高危权限 - 生成后页面只显示一次 token，复制完立即保存——刷新就再也看不到了
Gist ID 和 token 不是一回事
上传成功后返回的 Gist ID 是一串 32 位十六进制字符串（如 e534a3488059771452f9a0f69693ef14），和你输入的 token 完全不同。很多人混淆二者，导致在另一台机器上填错 ID 或重输 token，结果下载失败。
这个 ID 会出现在：
- 自动生成的 syncSummary.txt 文件顶部
- GitHub Gist 页面 URL 最后一段（https://gist.github.com/xxx/【这里就是ID】）
- VS Code 输出面板（Output → Settings Sync）
- 务必单独记录 ID，不要和 token 存在同一文本块里
- 如果忘了 ID，别去翻 token —— 直接访问
https://gist.github.com/your-username找最新创建的 private gist - 同一 token 可用于多个设备，但每个上传操作都会生成新 ID；下载时必须用对应上传时生成的那个 ID
Gist ID 一旦记错或丢失，就只能重新上传覆盖——旧配置不可找回。所以第一次上传成功后，花 10 秒把它粘贴到备忘录或密码管理器里，比什么都重要。
