直接升级即可，新版自动继承旧版设置和插件，但必须先彻底退出webstorm，否则易导致索引卡死或激活失败；推荐使用help→check for updates内置升级，避免重装引发路径、快捷方式及激活问题。
直接升级就行，不用重装、不用清配置，新版能自动继承旧版所有设置和插件——但前提是别跳过「更新前关掉 WebStorm」这一步，否则大概率卡在索引或激活失败。
WebStorm 升级前必须关掉 IDE
很多人升级后打不开项目、提示 Indexing stuck 或弹出重复登录框，根本原因就是没退出 WebStorm 就点 Check for Updates。IDE 在运行时会锁住 config 和 system 目录，升级程序无法安全覆盖关键文件。
- Windows/macOS：右上角菜单栏选
Help → Exit（macOS 是WebStorm → Quit WebStorm），不是关窗口，是彻底退出进程 - 确认进程已结束：
Activity Monitor（macOS）或Task Manager（Windows）里搜webstorm，确保无残留 - 升级完成后首次启动，会自动迁移
plugins、keymaps、live templates等，但如果你手动改过idea.properties或加过自定义 JVM 参数，得自己核对bin/webstorm64.vmoptions
升级方式选「Check for Updates」而不是重装
官网下载安装包再装一遍，看似稳妥，实则容易踩坑：路径冲突、桌面快捷方式错乱、命令行 webstorm 命令失效、甚至触发二次激活限制。官方推荐且最稳的路径就是 IDE 内置升级。
- 启动 WebStorm 后，进
Help → Check for Updates，有新版本就点Update and Restart - 如果提示「No updates available」但你知道已有 2025.3.1（当前最新），说明检查服务器缓存没刷新，点旁边小齿轮选
Check for updates automatically关掉再打开一次 - 升级包下载慢？在
Settings → Appearance & Behavior → System Settings → Updates里把更新频道切到Early Access Program（EAP），能提前拿到正式版发布当天的更新
升级后激活失效怎么办
2025.3.1 版本对非商业许可做了策略收紧，部分用户升级后看到 License expired 或弹窗要求重新登录 JetBrains 账户。这不是破解失效，而是许可校验逻辑变了。
- 先确认你用的是官方渠道激活：登录 JetBrains 账户并绑定邮箱，在
Help → Register里选Log in to JetBrains Account - 如果走的是
Free Non-Commercial Use流程，升级后需重新点一次Trust Project并等待几秒——它会在后台调用新的许可服务接口 - 仍失败？临时删掉
~/.WebStorm2025.3/system/cookies（macOS/Linux）或%USERPROFILE%\.WebStorm2025.3\system\cookies（Windows），重启再试
插件兼容性要手动点一下「Reload」
新版平台 SDK 变了，有些老插件（尤其是汉化包、旧版 ESLint 集成、自定义语言支持）不会自动适配，表现为功能消失或报 Plugin 'xxx' is incompatible with this version。
- 进
Settings → Plugins，顶部筛选器选Installed，挨个看右侧有没有黄色感叹号 - 有感叹号的插件，点右侧三个点 →
Reload plugin（不是卸载重装），多数能立刻恢复 - 如果插件作者没更新适配（比如某些 2022 年前的第三方插件），只能暂时禁用，等作者发新版；别强行勾选
Show incompatible plugins硬启，可能拖慢启动速度
真正麻烦的不是升级动作本身，而是升级后第一次打开大型项目时的索引重建——它会扫 node_modules 里的类型声明，如果项目用了 pnpm + workspace，记得在 Settings → Languages & Frameworks → JavaScript → Libraries 里手动把 pnpm-store 路径加进 Excluded，否则索引时间可能多出 2 分钟。
