必须用webstorm 2022.3及以上版本，登录jetbrains账户后手动点击upload now上传，否则云端为空；版本查help→about第一行，登录入口在settings→settings sync右上角，仅同步白名单配置，冲突时静默覆盖。
必须用 WebStorm 2022.3 及更高版本，登录 JetBrains 账户后手动上传，否则云端永远是空的。
确认版本和登录入口在哪
Settings Sync 功能不是所有版本都有——低于 2022.3 的 WebStorm（比如 2021.3）即使装了插件也无法完整同步。打开 Help → About 看第一行真实版本号，别信启动页 banner 或 Toolbox 显示的“最新”。
登录入口不在账户头像菜单里，而在：Settings → Settings Sync 页面右上角；灰掉或不显示，基本就是版本太低。
必须用 jetbrains.com 账户登录，GitHub/Google 只能用于首次注册，后续同步身份仍走 JetBrains 账户体系。
上传设置前必须做三件事
很多人点了“Enable Sync”就以为完事了，结果另一台设备拉下来全是旧配置——因为云端压根没新数据。
- 首次开启后，必须点一次
Upload now（或首次弹窗选Yes），否则不会自动推送到云端 - 主力机上改完设置（比如调了
keymap或Editor → Font size）后，WebStorm 不会实时同步，得手动点Upload now触发 - 如果之前误点过
No，或长期没上传，Upload now按钮会变成灰色——此时先点Disable Sync，再重新Enable Sync，按钮才会恢复可用
哪些配置能传、哪些根本传不了
Settings Sync 是白名单机制，不是全量镜像。以下这些能同步：
keymap、Editor → Color Scheme、Plugins list、Customize → UI Language（仅限 2024.3+ 版本且已手动设为中文并重启过）
以下这些永远不同步，别浪费时间排查：
-
.idea/目录下的项目级配置（如workspace.xml、runConfigurations/） - 所有含绝对路径的设置，比如
External Tools里写的C:\Python39\python.exe或/usr/local/bin/node -
File → Project Structure → SDKs和Project Libraries（路径天然跨设备不一致） - 部分插件私有状态，比如
GitToolBox的正则历史、String Manipulation的操作记录
同步冲突时 WebStorm 不提醒，只静默覆盖
这是最危险的一点：你在公司电脑改了快捷键，在家又改了一版，回家点 Download settings，本地设置直接被云端覆盖，不弹窗、不比对、不备份。
实操建议：
- 日常只在一台主力机上改设置，其他设备勾选
Download settings on startup，但不要勾选Upload settings automatically - 定期手动导出本地快照：
File → Export Settings，存成settings.jar备份 - 如果某天发现快捷键全乱了，别反复开关 Sync——直接进
Settings → Keymap手动重置，或从本地快照导入
真正容易被忽略的不是怎么上传，而是同步后是否生效——比如中文界面要 2024.3+ + 主力机已重启上传 + 新设备必须重启 IDE 才切换，中间漏一环，就卡在英文界面不动。
