VSCode官方Settings Sync已于2023年底弃用，现需通过GitHub账号+Shan Khan开发的Settings Sync扩展实现同步；该扩展默认不同步插件和本地设置，须手动启用syncExtensions、选择Merge模式、排除敏感路径字段，并每次修改后手动执行Sync: Upload或Sync: Download。
VSCode 官方 Settings Sync 功能在 2023 年底已弃用，现在必须依赖 GitHub 账号 +
扩展（作者 Shan Khan）才能实现跨设备同步；它不走微软服务器，所有数据存你自己的 GitHub Gist 中，但默认不自动同步，每次改配置或装插件后都得手动上传。
怎么装和登录 Settings Sync 扩展
扩展市场搜
，确认作者是
（ID：
），安装后重启 VSCode。按
（Windows/Linux）或
（macOS），输入
并执行。浏览器会跳转到 GitHub 授权页，必须勾选
权限——其他权限一律不选，否则 token 不安全。授权完成后，VSCode 会提示是否上传当前配置，选
即生成一个新 Gist。
插件没同步过来？检查这三个关键开关
默认不同步插件列表，必须手动开启。常见错误现象：左下角显示
，但另一台电脑上插件全空。原因通常是：
GitHub Copilot
GitHub AI编程工具，实时编程建议
下载
开关未启用：运行
→
首次开启时误选了
：这会清空本地插件列表再重装远端清单，应选
保留已有插件
扩展实际未安装：同步只管“启用/禁用状态”和“安装清单”，
这类大体积插件仍需手动点插件面板里的刷新按钮或等
触发
哪些 settings.json 字段不该同步，否则会出问题
全局
里混着机器级路径，一同步就报错。比如
指向
，同步到 macOS 上直接让 Python 扩展崩溃。这类字段必须排除：
绝对路径类：如
、
敏感字段：SSH 密钥路径、API tokens、自定义证书路径等，Gist 是私有但非加密存储，别往里写
工作区设置：所有
内容默认不同步，这是设计使然，避免项目配置污染全局
排除方式：在用户
中加
多台电脑之间怎么避免覆盖冲突
同步本质是覆盖式更新，没有合并逻辑。两台电脑同时改并上传，后上传的会直接覆盖先上传的。这不是 bug，是 Gist 存储模型决定的。容易被忽略的关键点：
换电脑前务必先运行
，拉取最新配置再开始工作
某台电脑做了大量临时修改（比如调试时禁用一堆插件），上传前要确认是否真想推送到所有设备
Gist 描述可手动加标签，如
或
，方便在 GitHub 上人工比对版本
如果发现某台电脑插件没同步，先看
输出里有没有
报错
Settings SyncSettings SyncShan Khanshanalikhan.settings-syncCtrl+Shift+PCmd+Shift+PSync: Turn OngistYesSettings SyncSyncedsyncExtensionsSync: Advanced OptionsToggle Extension SyncReplaceMergems-python.pythonextensions.autoUpdatesettings.jsonpython.defaultInterpreterPathC:\Users\Alice\AppData\Local\Programs\Python\Python311\python.exeterminal.integrated.shell.linuxgit.path.vscode/settings.jsonsettings.json"settingsSync.ignoredSettings": ["python.defaultInterpreterPath", "terminal.integrated.shell.osx"]Sync: Downloadlaptop-2024-q2desktop-workSync: Show OutputExtension sync disabled