Settings Sync插件不支持云端恢复、历史回滚或冲突解决,仅单向覆盖;需手动安装Shengbin Chen版并重启IDE;仅支持GitHub/GitLab/Bitbucket的特定权限令牌;Keymap等需手动启用同步;无合并机制,最后上传者覆盖全部设备。

不能直接“云端恢复”,Settings Sync 插件不提供历史版本回滚或冲突还原功能,它只做单向覆盖——最后一次 Push 的内容,就是所有设备的最终状态。
Settings Sync 按钮不出现,根本没法同步
这不是配置问题,而是插件没真正激活。2023.3+ 版本已移除内置支持,必须手动安装第三方版本。
- 打开
Settings → Plugins,搜索Settings Sync,认准作者是Shengbin Chen(别选 JetBrains 官方旧版或同名仿冒插件) - 安装后必须重启 IDE,否则右下角不会渲染云朵图标或
Sync Settings按钮 - 重启后仍不显示?进
Plugins列表检查该插件右侧开关是否为开启状态——禁用时图标完全不加载 - 若提示
Plugin 'Settings Sync' is incompatible with this version,说明你误启用了旧版内置插件(如 2021.x 自带),需先卸载再装新版
登录失败:Failed to sync: Unauthorized
这个插件不走 JetBrains 账号体系,只认 GitHub/GitLab/Bitbucket 的个人访问令牌(PAT),且权限极窄,多选或少选都会失败。
- GitHub 用户:去
https://github.com/settings/tokens新建 token,**仅勾选gist权限**(多选会触发 403) - GitLab 用户:必须用
Personal Access Token(不是 Deploy Token),勾选api和read_user - 国内用户常因默认调 GitHub gist API 超时失败,可改用 GitLab 作为后端,更稳定
- 粘贴 token 后务必点
Test Connection,成功才算凭证有效;失败常见原因是 token 过期、代理拦截、或权限未保存
Keymap / Live Templates / Colors 同步后不生效
插件默认不同步这些高频项,即使登录成功、按钮可见,它们也处于关闭状态,不会自动传输。
立即学习“PHP免费学习笔记(深入)”;
- 进
Settings → Tools → Settings Sync,滚动到底部,在Synced Settings区域手动勾选:Keymap、Live Templates、Color Scheme、File Templates、Inspection Profiles - 第三方主题(如
Nord、One Dark Pro)需提前在目标机器安装对应插件,否则colors.scheme.xml被静默跳过 - 快捷键方案若存在同名冲突(如都叫
Default),插件会新建Default (1),需手动进Settings → Keymap设为默认 - 每次同步前建议先点
Pull再Push,防止本地覆盖远端最新配置
最易被忽略的一点:Settings Sync 没有合并机制,也没有时间戳比对逻辑。它只认“最后上传者”,A 机改完快捷键,B 机一开就强制覆盖还原——这不是 bug,是设计如此。真要团队共用配置,得换 Settings Repository 方案。


















