webstorm settings sync 默认不启用，需登录 jetbrains 账户且版本≥2022.3；仅同步白名单配置（如快捷键、字体），排除项目级设置、绝对路径、部分插件及 sdk 配置；同步冲突会静默覆盖，建议主力机上传、其他设备只下载，并定期导出本地快照。
WebStorm 的 Settings Sync 功能默认不启用，且依赖 JetBrains 账户而非 GitHub
Settings Sync 不是开箱即用的功能，必须手动登录 JetBrains 账户并开启同步开关。很多人卡在第一步：点 Settings → Appearance & Behavior → System Settings → Settings Sync，发现“Sign in”按钮灰掉或根本没出现——这是因为 WebStorm 2022.3 及之后版本才内置该功能，旧版本（如 2021.x）即使装了插件也受限于 API 权限，无法完整同步。
实操建议：
- 确认 WebStorm 版本 ≥
2022.3（Help → About 查看），低于此版本请升级，别折腾插件 - 登录入口在
Settings → Settings Sync页面右上角，不是账户头像菜单里 - 必须使用 JetBrains 账户（jetbrains.com 账号），
GitHub或Google登录方式仅用于首次注册，后续同步仍走 JetBrains 身份体系 - 首次开启时会提示“Upload settings to cloud”，选
Yes；若误点No，需手动点击Upload now按钮触发上传
哪些配置能同步，哪些永远不同步
Settings Sync 并非“全量镜像”，它按 JetBrains 官方定义的白名单同步，比如 keymap、editor font size、plugins list 会同步，但以下几类明确排除：
-
.idea/目录下的项目级配置（如workspace.xml、runConfigurations/）——这些属于本地开发状态，不同设备打开同一项目时自动重建 - 绝对路径相关的设置，例如
External Tools中硬编码的C:\Python39\python.exe或/usr/local/bin/node，同步后在另一台设备上会失效甚至报错 - 部分插件的私有配置（如
GitToolBox的自定义正则、String Manipulation的历史记录）不在同步范围内 -
File → Project Structure → SDKs和Project Libraries永远不同步，因为 SDK 路径天然不一致
同步冲突时 WebStorm 不提醒，而是静默覆盖本地设置
这是最危险的一点：当你在两台设备上分别修改了同一项设置（比如都改了 Editor → Color Scheme），然后其中一台执行了 Download settings，它会直接用云端版本覆盖本地，不会弹窗、不比对时间戳、也不生成备份。你可能第二天打开 WebStorm，发现所有快捷键突然变了，却想不起在哪动过。
实操建议：
- 日常只在一台主力机上做配置变更，其他设备保持只读同步（即只勾选
Download settings on startup，不勾选Upload settings automatically） - 手动同步前，先在
Settings Sync页面点Compare with cloud，查看差异项再决定是否下载 - 定期导出本地配置快照：
File → Export Settings…→ 保存为settings.jar，文件名带上日期，比如settings-20240520.jar - 如果已覆盖出错，可从
Settings Sync页面点击Restore from backup（仅保留最近一次上传前的本地状态）
插件没同步成功？先检查插件是否支持 Settings Sync 白名单
不是所有插件都能被 Settings Sync 管理。比如 Markdown Navigator、PlantUML Integration 这类老牌插件，其配置存储在 ~/.WebStorm2023.x/config/options/ 下独立 XML 文件中，不在同步路径内；而 Tabnine、Code With Me 等 JetBrains 官方或深度集成插件，则默认支持。
判断方法很简单：在 Settings → Settings Sync 页面拉到最底部，展开 Advanced options → Show settings that will be synced，搜索插件名。如果列表里没有，说明它不在白名单里。
替代方案：
- 对关键插件（如
Key Promoter X），手动导出其配置：进入Help → Diagnostic Tools → Debug Log Settings，临时加日志项#com.intellij.configurationStore，重启后查看日志中插件配置路径，再用脚本打包同步 - 用
File → Manage IDE Settings → Export Settings…导出时，手动勾选对应插件的配置项（如果有） - 更稳妥的做法：把常用插件列表写成文本，放在云盘，新设备装完 WebStorm 后按单安装，再逐一手动配
Compare with cloud，比事后翻 log 强得多。
