Settings Sync 插件在 PhpStorm 2023.3+ 已被 JetBrains 移除内置支持,需手动安装 Shengbin Chen 版本、配置 GitHub/GitLab PAT(仅 gist 或 api+read_user 权限)、逐项启用 Keymap 等同步项,且无合并逻辑;推荐改用官方维护的 Settings Repository 插件实现 Git 化协同。

直接说结论:Settings Sync 插件在 PhpStorm 2023.3+ 已被 JetBrains 移除内置支持,不能靠“开个开关”同步;必须手动安装第三方插件、配 PAT 凭证、逐项勾选同步项,且它没有合并逻辑——A 机改完快捷键,B 机一开就覆盖还原。
Settings Sync 插件装了但右下角没 Sync 按钮
这不是配置错了,是插件根本没激活或版本不兼容。
- 打开
Settings → Plugins,搜Settings Sync,只认作者 Shengbin Chen 的版本(别选错同名插件) - 安装后必须重启 IDE,否则状态栏不会渲染云朵图标或
Sync Settings按钮 - 重启后仍不显示?进 Plugins 列表检查右侧开关是否为开启状态——禁用时图标完全不出现
- 若提示
Plugin 'Settings Sync' is incompatible with this version,说明你启用了旧版内置插件(如 2021.x 自带),需先卸载再装新版
同步失败报 Failed to sync: Unauthorized
这个插件不走 JetBrains 账号,只认 GitHub/GitLab/Bitbucket 的个人访问令牌(PAT),且权限极窄,多选反而出错。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
- GitHub 用户:去
https://github.com/settings/tokens新建 token,**仅勾选gist权限**(别加repo或admin:org) - GitLab 用户:必须用
Personal Access Token,勾选api和read_user;Deploy Token不支持 - 国内用户常卡在连接超时——插件默认调 GitHub gist API,可改用 GitLab 后端更稳定
- 粘贴 token 后务必点
Test Connection,成功才算凭证有效;失败常见原因是 token 过期、代理拦截、或权限未保存
Keymap / Live Templates / Colors 导入后不生效
Settings Sync 默认不同步这些高频项,即使插件已启用,它们也处于关闭状态。
- 进
Settings → Tools → Settings Sync → Settings,滚动到底部,在Synced Settings区域手动勾选:Keymap、Live Templates、Color Scheme、File Templates - 第三方主题(如
Nord、One Dark Pro)需提前在目标机器安装对应插件,否则colors.scheme.xml会被跳过 - 快捷键方案若存在同名冲突(如都叫
Default),插件会新建Default (1),需手动进Settings → Keymap设为默认 - 每次同步前建议先点
Pull再Push,防止本地覆盖远端最新配置
Settings Repository 才是长期协作的正解
Settings Sync 是单向强覆盖,而 Settings Repository 基于 Git,能 review、回退、分支管理,且官方仍在维护(2022.3 后需手动安装,但功能完整)。
- 安装
Settings Repository插件后,进File → Settings Repository,填入私有 Git 仓库地址(支持 GitHub/GitLab/本地裸库) - 首次配置后点
Overwrite on server上传当前设置;另一台设备填相同 URL,点Load settings即可拉取 - 它自动处理版本适配逻辑,跨大版本(如 2024.3 → 2025.1)也不易出错;而 Settings Sync 的
.jar导入包在格式变更时可能静默失效 -
vmoptions文件永远不在任何同步范围内,必须单独备份迁移——漏掉会导致启动卡顿、OutOfMemoryError或激活失效
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!









