WebStorm 启动慢主因是默认512MB堆内存不足，应按物理内存调整VM参数；禁用无关插件、排除node_modules等目录、清理缓存并彻底重启可显著提速。
WebStorm 启动慢？大概率是 JVM 内存卡在默认值上
WebStorm 默认只给 512MB 堆内存，而现代前端项目（尤其带 node_modules、TypeScript、Vite 或 Webpack 的）一启动就要加载数万文件、解析类型、构建索引——这点内存连“喘口气”都不够，JVM 频繁 GC，启动自然卡在“正在加载项目”或“正在索引”不动。
实操建议：
- 打开
Help → Edit Custom VM Options，首次会提示创建文件；别手抖点取消 - 把默认的
-Xms256m -Xmx512m换成更务实的值：
8GB 物理内存 →-Xms1024m -Xmx2048m
16GB 物理内存 →-Xms2048m -Xmx4096m
32GB+ 且主力跑大型 monorepo → 可试-Xms4096m -Xmx8192m，但-Xmx别超物理内存 1/3 - 顺手加一行：
-XX:ReservedCodeCacheSize=1024m，避免 TS/JS 语言服务因代码缓存满而降级 - 改完必须完全退出 WebStorm（不是关闭窗口），再重启——否则参数不生效
为什么禁用插件比升级硬件还立竿见影
一个插件可能在启动时就初始化远程连接、扫描全部文件、甚至拉起独立 Node 进程。比如 Kotlin、Android Support、Eclipse Integration 这类和前端无关的插件，根本不会被触发功能，却全程吃 CPU 和内存。
实操建议：
- 进
Settings → Plugins，切换到Installed标签页 - 按「启用状态」排序，把灰色（已禁用）插件直接删掉；把绿色（已启用）但你从没点开过的，先禁用
- 重点检查：
Subversion Integration（除非真用 SVN）、Database Tools and SQL（没连 DB 就关）、Mercurial（同理） - 保留刚需三件套：
Git Integration、JavaScript Debugger、Node.js；TypeScript Language Service如果项目用 TS 就留着
node_modules 和 dist 目录还在被索引？那启动就是在白干
WebStorm 启动时默认递归扫描整个项目目录。一个 node_modules 动辄 2–5 万文件，全索引一遍不仅拖慢启动，还会让后续搜索、跳转变迟钝——因为 IDE 在海量无意义符号里找你要的函数。
实操建议：
- 在项目视图中，右键点击
node_modules→Mark Directory as → Excluded - 同样处理
dist、build、.next、.nuxt、coverage等产出目录 - 别信“我只 exclude 一层”，要确保子目录也生效——Excluded 图标（灰色文件夹）得出现在整个目录树上
- 如果用了 pnpm 或 yarn pnp，还要额外检查：
Settings → Languages & Frameworks → JavaScript → Libraries，确认没把node_modules手动加进库路径
缓存坏了不清理，调再大内存也没用
IDE 缓存损坏很常见：比如强制杀进程、磁盘满后恢复、跨版本升级 WebStorm……这时索引文件错位、符号表断裂，表现就是启动卡在 90%、文件打不开、跳转失效——你调了 -Xmx8g，它还是卡，因为问题根本不在内存，而在缓存本身。
实操建议：
- 菜单选
File → Invalidate Caches and Restart → Invalidate and Restart - 别选 “Just Restart”，那只是重启，缓存照坏
- 第一次清理后，IDE 会重建索引，头几次打开稍慢属正常；等进度条走完，再看启动时间
- 如果频繁出问题，可以定期执行（比如每周一次），或在升级 WebStorm 后必做
最容易被忽略的一点：改了 webstorm.vmoptions 却没关干净所有 WebStorm 进程——Windows 任务管理器里残留 java.exe，macOS 活动监视器里还有 WebStorm 进程，都会导致新配置不加载。关之前，务必确认进程已清空。
