macOS Disk Suddenly Full? It Was Spotlight — Here’s the FixDNX |
The Symptoms
Disk space kept shrinking rapidly
System showed hundreds of GB used, but files didn’t add up
Cleaning caches and dev folders didn’t fix it
Reboot temporarily helped, but the issue came back
The Key Discovery
Running a proper disk scan revealed this:
sudo du -xhd 1 /System/Volumes/Data | sort -hr | head
Output showed:
200G /System/Volumes/Data/.Spotlight-V100
👉 The Spotlight index alone was consuming ~200GB
A healthy Spotlight index is usually only a few GB.
Root Cause
Spotlight was indexing a high-churn development environment:
Node / Expo projects
Android builds (Gradle)
Large numbers of small files (node_modules, build artifacts)
What happened
constant file changes triggered re-indexing
metadata accumulated rapidly
index became unstable and eventually corrupted
macOS never cleaned it up
What Didn’t Work
Before identifying the root cause:
clearing ~/Library/Caches
cleaning Xcode / Android artifacts
checking Time Machine snapshots
checking deleted-but-open files
None of these solved the issue.
The Fix
Step 1 — Disable Spotlight temporarily
sudo mdutil -i off /
Step 2 — Rebuild the index
sudo mdutil -E /
If disk usage does not improve, see the Safe Mode section below.
Step 3 — Verify disk recovery
df -h /
👉 Disk space returned to normal immediately.
When Rebuild Doesn’t Work
In some cases, the Spotlight index may be corrupted or locked, and the normal rebuild does not remove it.
If you still see a large .Spotlight-V100 folder (for example, tens or hundreds of GB), use Safe Mode to remove it.
Safe Mode Cleanup
Step 1 — Boot into Safe Mode
On Apple Silicon (M1/M2/M3):
Shut down your Mac
Press and hold the Power button
When startup options appear:
Select your disk
Hold Shift
Click Continue in Safe Mode
Step 2 — Delete the Spotlight index
Open Terminal and run:
sudo rm -rf /System/Volumes/Data/.Spotlight-V100
Step 3 — Reboot normally
Restart your Mac.
Step 4 — Rebuild Spotlight
sudo mdutil -i on /
sudo mdutil -E /
Why Safe Mode Helps
Safe Mode:
disables Spotlight services
prevents files from being locked
allows full removal of corrupted index data
Prevent It From Happening Again
Exclude development folders
Go to:
System Settings → Spotlight → Privacy
Add:
~/Projects
Optional (enforce via CLI)
touch ~/Projects/.metadata_never_index
Why This Matters
Spotlight is not designed for:
millions of rapidly changing files
build artifacts
dependency folders
Result
index bloat
corruption
disk exhaustion
Recommended Setup
Spotlight: ON
Siri / Apple Intelligence: OFF (optional)
Dev folders (~/Projects): EXCLUDED
Takeaway
If your macOS disk:
fills up unexpectedly
doesn’t match actual file usage
keeps growing over time
👉 Check .Spotlight-V100 first.
It might not be your files —
it might be the search index itself.
Useful Commands
# Check disk usage
df -h /
# Find large folders
sudo du -xhd 1 /System/Volumes/Data | sort -hr | head
# Rebuild Spotlight index
sudo mdutil -E /
# Disable Spotlight (temporary)
sudo mdutil -i off /
# Exclude folder from indexing
touch ~/Projects/.metadata_never_index