最安全有效的方法是使用 WebStorm 内置的 Invalidate Caches / Restart 功能，它会协调删除缓存、重置索引、清空本地历史并自动重建；手动删目录仅在 IDE 无法启动或插件异常时才考虑。
如果您在使用 WebStorm 时发现 macOS 系统磁盘空间被大量占用，且通过磁盘分析工具定位到 WebStorm 的索引目录（如 system/caches 或 system/indexes）占用了数 GB 空间，则这些是 WebStorm 在项目分析过程中生成的本地缓存与索引文件。以下是清理 WebStorm 系统索引、释放 GB 级空间的具体操作方法：
一、通过 WebStorm 内置功能清除索引与缓存
WebStorm 提供了图形化界面的一键清理机制，可安全删除所有临时索引、代码补全缓存、语法解析数据等非项目源文件，不会影响您的源码或配置。
1、启动 WebStorm，确保已打开任意项目或处于欢迎界面。
2、点击顶部菜单栏的 WebStorm → Clear Caches and Restart…（macOS 系统下路径）。
3、在弹出窗口中勾选 Clear file system cache and Local History 及 Delete downloaded shared indexes（如有）。
4、点击 Clear and Restart，等待 IDE 重启完成。
二、手动删除系统索引目录（适用于缓存未被完全清除或 IDE 崩溃无法启动）
WebStorm 的系统级索引默认存储在 macOS 用户目录下的 ~/Library/Caches/JetBrains/WebStorm*/ 和 ~/Library/Caches/JetBrains/IntelliJIdea*/（旧版本可能混用）以及 ~/Library/Caches/JetBrains/WebStorm版本号/caches/ 中；其中 indexes 子目录通常单独存放符号索引，体积最大。
1、退出 WebStorm，确保其进程已终止（可在活动监视器中搜索 “webstorm” 并强制退出）。
2、打开 Finder，按下 Shift + Command + G，输入路径：~/Library/Caches/JetBrains/，回车进入。
3、找到以 WebStorm 开头的文件夹（例如 WebStorm2023.3 或 WebStorm2024.1），进入后定位到 caches/indexes/ 子目录。
4、选中整个 indexes 文件夹，按 Command + Delete 彻底删除；如需更彻底清理，可一并删除同级的 caches/（不含 plugins/）和 compile/ 目录。
三、禁用或限制共享索引下载（预防未来重复膨胀）
WebStorm 默认会从 JetBrains 服务器下载预构建的共享索引（Shared Indexes），用于加速大型框架（如 JDK、Spring、React）的符号解析，但这些索引单个可达 1–3 GB，且本地不自动过期。
1、打开 WebStorm，进入 Preferences（Command + ,）。
2、导航至 Advanced Settings → Shared Indexes。
3、取消勾选 Enable shared indexes；或保留启用状态，但点击右侧 Manage Shared Indexes…，在列表中选择已下载项，点击 Remove 删除全部。
4、返回后点击 Apply，再执行一次 Clear Caches and Restart 以生效。
四、调整索引范围排除无关目录（降低索引体积）
WebStorm 默认对整个项目目录递归索引，若项目含 node_modules、dist、build、.git 等巨型子目录，将显著增加索引大小。可通过标记为“排除”来跳过索引生成。
1、在项目视图中右键点击目标文件夹（如 node_modules）。
2、选择 Mark Directory as → Excluded。
3、重复操作，对 dist、build、out、.next、target 等产出目录执行相同操作。
4、完成后，WebStorm 将在下次索引重建时跳过这些目录，可减少索引体积达 60% 以上。
五、使用终端命令批量清理历史缓存残留
部分旧版 WebStorm 升级后，前代缓存目录可能滞留在 Library 中未被自动清理，尤其当版本号变更频繁时（如从 2023.2 升至 2024.1）。这些残留可手动或脚本式清除。
1、打开终端（Terminal），粘贴并执行以下命令：
find ~/Library/Caches/JetBrains -name "indexes" -type d -maxdepth 3 -exec du -sh {} \; | grep -E "^[0-9.]+G"
2、确认输出中列出的路径确属已弃用版本（如 WebStorm2022.3/indexes），再执行删除：
rm -rf ~/Library/Caches/JetBrains/WebStorm2022.3/indexes
3、如需清理全部旧版 indexes，可运行：
find ~/Library/Caches/JetBrains -name "indexes" -type d -mtime +180 -delete（仅删除 180 天前创建的 indexes 目录）。
