PhpStorm Indexing Takes Forever / Stuck on Indexing

How to fix it

Try these in order — the most common fix is first.

1. 1. Exclude folders you do not edit

   Copy steps
   1. In the Project tool window right-click the folder
   2. Choose Mark Directory as | Excluded
   3. Repeat for vendor, node_modules, storage/framework and var/cache
   4. Wait for indexing to finish once
   Did this fix it? Yes No

2. 2. Invalidate caches

   Copy steps
   1. Open File | Invalidate Caches
   2. Tick the options you want to clear and click Invalidate and Restart
   3. Let the full re-index finish before working
   Did this fix it? Yes No

3. 3. Exclude the project and IDE caches from antivirus

   Copy steps
   1. Add the project folder and the IDE system/cache folder to your antivirus exclusions
   2. Restart the IDE
   Did this fix it? Yes No

Symptoms

The status bar shows "Indexing..." or "Updating indexes" for a long time, code completion and navigation are unavailable, and fans spin up.

Why it happens

• Huge generated or dependency folders (vendor, node_modules, storage/framework and var/cache) inside the project root
• Corrupted caches after a crash, update or forced shutdown
• Antivirus scanning the IDE caches and project folder in real time
• Project stored on a slow network drive or synced folder (Dropbox, OneDrive)
• Too little heap memory, so the indexer keeps garbage collecting

This guide also covers

• phpstorm indexing forever
• phpstorm stuck on indexing
• phpstorm indexing slow
• phpstorm updating indexes

Other PhpStorm errors

• PhpStorm Xdebug Not Connecting / Breakpoints Not Hit
• PhpStorm PHP Interpreter Is Not Configured
• PhpStorm Composer and Laravel Not Working (Autocomplete, Undefined Class)
• PhpStorm Out of Memory: How to Increase Heap Size
• Why Is PhpStorm So Slow / Freezing?
• PhpStorm License Activation Error / License Not Found
• PhpStorm Plugin Incompatible After Update
• PhpStorm AI Assistant Quota Exceeded / Not Working