Zed High CPU Usage or Freezing

How to fix it

// try these in order, the most common fix is first

1. FIX 1Restart language server

   1. 01Command palette: editor: restart language server
   Did this fix it? Yes No

2. FIX 2Update Zed

   1. 01Zed: about to check version, update
   Did this fix it? Yes No

3. FIX 3Check the log

   1. 01Command palette: zed: open log
   Did this fix it? Yes No

4. FIX 4Reset workspace database

   Copy steps
   1. 01Move ~/.local/share/zed/db (Linux), ~/Library/Application Support/Zed/db (macOS) or %LOCALAPPDATA%\Zed\db (Windows)
   2. 02Restart Zed (recent projects reset)
   Did this fix it? Yes No

5. FIX 5Report

   1. 01Run zed: copy system specs into clipboard and file a GitHub issue
   Did this fix it? Yes No

Symptoms

Fans spin, Zed uses 100% CPU or hangs.

Why it happens

• C-01Graphics driver bug after sleep
• C-02Runaway language server
• C-03Large project indexing

// this guide also covers

• zed high cpu
• zed freezing
• why is zed using so much cpu

The same problem in other apps

All crashes, freezes & blank screens guides →

• Sublime Text Crashing or Misbehaving: Use Safe Mode (Sublime Text)
• GitHub Copilot Chat Not Responding (GitHub Copilot)

Other Zed errors

• Zed Vulkan Error on Linux (NoSupportedDeviceFound)
• Zed Blank or Invisible Window on Linux
• Zed Slow on Linux Laptop (Using Wrong GPU)
• Zed Too Many Open Files Error on Linux
• Zed Wrong Scaling on High-DPI Linux (X11)
• Zed Language Server Not Working
• Zed Won't Start or Crashes on Launch
• Zed Agent 'Max Tokens Reached' Error