最稳升级方式是help → check for updates，但必须先彻底退出webstorm进程，否则ide锁住config/system目录致升级失败，引发indexing stuck、重复登录、license expired等问题。
直接用 Help → Check for Updates 升级最稳，不用重装、不丢配置、不破坏激活状态——但必须先彻底退出 WebStorm 进程，否则大概率卡在索引或弹出重复登录框。
为什么升级后打不开项目或反复要求登录
根本原因是 IDE 运行时锁住了 config 和 system 目录，升级程序无法安全覆盖关键文件。常见现象包括：Indexing stuck、License expired、新窗口空白、插件失效。
- Windows：右键任务栏 → “任务管理器” → 搜索
webstorm64.exe或webstorm.exe，结束所有相关进程 - macOS：打开“活动监视器”，搜索
webstorm，强制退出全部匹配项 - Linux：运行
pkill -f webstorm或检查ps aux | grep webstorm - 确认无残留后再启动 IDE，再点
Help → Check for Updates
更新通道选 Stable 还是 EAP
除非你明确需要尝鲜最新特性（比如试用 TypeScript 5.7 的装饰器稳定语法支持），否则别开 Early Access Program。EAP 版本可能含未修复的崩溃 bug，且 2026.1 EAP 不能直接升到 2026.1 正式版，而是会作为独立实例并存。
- 生产环境开发：在
Settings → Appearance & Behavior → System Settings → Updates中选Stable Releases - 想提前拿到 2026.1 正式包（比如官网还没同步，但你已知版本号）：临时切 EAP，升级完立刻切回 Stable
- 用 Toolbox App 管理的实例：IDE 内的
Updates设置只影响插件，IDE 本身升级需在 Toolbox 里操作
升级后激活失效怎么办
2026.1 对非商业许可做了校验逻辑调整，并非破解失效。Free Non-Commercial Use 用户只需重新走一遍信任流程，不是重输许可证。
- 进
Help → Register→ 选Log in to JetBrains Account，确保邮箱已绑定官方账户 - 回到项目界面，点击弹窗里的
Trust Project，等几秒——后台会调用新许可服务接口 - 仍失败？临时删掉
~/.WebStorm2026.1/config/eval（macOS/Linux）或%USERPROFILE%\.WebStorm2026.1\config\eval（Windows），重启 IDE - 不要删整个
config目录，否则丢失 keymap、live templates 等个性化设置
真正容易被忽略的是：升级前没关掉所有 WebStorm 窗口，只点了 × 关闭主窗口；或者用了 Toolbox App 却还在 IDE 里手动点更新，导致策略冲突。这两个动作加起来占了 80% 的升级失败案例。
