När du öppnar Terminal på Macen och får zsh: command not found: brew betyder det oftast att Zsh inte hittar Homebrew, men felet kan också betyda att Homebrew saknas helt. Börja med att kontrollera om programmet finns på datorn innan du ändrar sökvägar eller installerar om.

Kontrollera först om Homebrew finns på rätt plats
- Apple-chip: standardplatsen är
/opt/homebrew. - Intel-Mac: standardplatsen är
/usr/local. - Linux: standardplatsen är
/home/linuxbrew/.linuxbrew. - Om filen finns: problemet handlar sannolikt om Zshs
PATH, alltså listan över platser där skalet letar efter kommandon. - Om filen saknas: kontrollera om Homebrew installerats någon annanstans innan du installerar det igen.
Ta reda på om brew är installerat
Felmeddelandet säger bara att Zsh inte hittade kommandot i sin aktuella sökväg. Det bevisar inte att Homebrew saknas. Jag tycker att det är säkrast att kontrollera den väntade installationsplatsen först, eftersom en onödig ominstallation kan skapa dubbla installationer.
Kör kommandot som passar datorn. På Mac kan du identifiera processorarkitekturen med uname -m: arm64 brukar betyda Apple-chip och x86_64 Intel. På Linux används normalt den separata Linux-sökvägen.
- Apple-chip:
ls -l /opt/homebrew/bin/brew - Intel-Mac:
ls -l /usr/local/bin/brew - Linux:
ls -l /home/linuxbrew/.linuxbrew/bin/brew
Om filen finns kan du testa den direkt med dess fullständiga sökväg, till exempel /opt/homebrew/bin/brew --version på en Apple-chip-Mac. Fungerar det, pekar felet på PATH eller Zshs startkonfiguration. Om filen saknas på den förväntade platsen behöver du kontrollera om Homebrew finns i ett anpassat installationsprefix innan du går vidare.
Välj sökväg efter datorns processor
En enda felaktig sökväg kan få en fungerande installation att se trasig ut. Homebrews FAQ anger olika standardprefix för Apple-chip, Intel-Mac och Linux. De är inte utbytbara: lägger du in Intel-sökvägen på en Apple-chip-Mac pekar Zsh sannolikt på en katalog som saknar Homebrew.
| Miljö | Standardprefix | Kommandot för aktuell session |
|---|---|---|
| macOS med Apple-chip | /opt/homebrew |
eval "$(/opt/homebrew/bin/brew shellenv zsh)" |
| macOS med Intel | /usr/local |
eval "$(/usr/local/bin/brew shellenv zsh)" |
| Linux | /home/linuxbrew/.linuxbrew |
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv zsh)" |
Kör raden som motsvarar din installation i Terminal. Om brew --version sedan fungerar har du bekräftat att Homebrew finns och att felet låg i den aktuella skalets miljö. Ändringen gäller dock bara den session där du körde kommandot, så nästa steg är att spara inställningen på rätt plats.
Spara inställningen i en Zsh-fil som faktiskt läses
På macOS är ~/.zprofile ofta rätt plats för Homebrews miljöinställning när Terminal startar ett inloggningsskal. Zsh läser den filen före ~/.zshrc, medan ~/.zshrc läses för interaktiva skal. Därför kan instruktioner som säger att du alltid ska använda samma fil bli missvisande.
Zshs dokumentation om startfiler beskriver när filerna läses. På macOS kan du, om Homebrew finns i standardplatsen, lägga till rätt rad så här:
- Apple-chip:
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile - Intel-Mac:
echo 'eval "$(/usr/local/bin/brew shellenv zsh)"' >> ~/.zprofile
Öppna sedan ett nytt Terminal-fönster och kör command -v brew. Det ska visa den fullständiga sökvägen till kommandot. På Linux använder du en startfil som faktiskt läses i din miljö, ofta ~/.zshrc; Homebrews installationsanvisningar anger att rätt konfigurationsfil beror på skalet och systemet.
Felsymtomet visar vilket spår du ska följa
Det är lätt att fastna i att ändra PATH om och om igen, trots att orsaken är en annan. Använd resultatet från kontrollen av den fullständiga sökvägen för att välja nästa åtgärd:
| Situation | Trolig orsak | Gör så här |
|---|---|---|
Full sökväg till brew fungerar, men brew gör det inte |
Homebrews katalog saknas i skalets PATH. |
Kör brew shellenv från rätt prefix och spara raden i en startfil. |
| Filen finns inte på den väntade platsen | Homebrew kan saknas eller ligga i ett annat prefix. | Kontrollera processorarkitektur och befintliga installationsplatser innan eventuell ominstallation. |
| Det fungerar i Terminal men inte i en app eller ett byggverktyg | Programmet kan starta med en annan miljö och sakna Terminalens PATH. |
Kontrollera programmets miljö och testa kommandot med full sökväg där det körs. |
| Felet kommer tillbaka i nya Terminal-fönster | Raden ligger i en fil som skalet inte läser, eller skrivs över senare. | Kontrollera ~/.zprofile och ~/.zshrc efter motstridiga PATH-inställningar. |
Särskilt i skript, CI-jobb och utvecklingsmiljöer kan Terminal och körmiljön ha olika sökvägar. Därför är ett lyckat test i ett Terminal-fönster inte alltid bevis på att ett automatiserat jobb hittar samma kommando.
Undvik dubbla sökvägar och onödig ominstallation
En återkommande fälla är en senare rad i ~/.zshrc som ersätter hela PATH, till exempel export PATH="/annan/katalog". Då kan Homebrew ha lagts till korrekt i ~/.zprofile, men ändå försvinna när en interaktiv Zsh-session startar. Sök efter alla relevanta rader med grep -n 'PATH\|brew shellenv' ~/.zprofile ~/.zshrc ~/.zshenv 2>/dev/null.
Om en rad börjar med export PATH= bör du kontrollera att den bevarar befintliga sökvägar när det behövs, ofta genom att inkludera $PATH. Lägg inte till flera varianter av Homebrews sökväg på måfå; välj rätt prefix och låt brew shellenv sätta upp miljön.
Om Homebrew verkligen saknas installerar du det via Homebrews installationsanvisningar och följer instruktionerna som visas efter installationen. De innehåller den sökväg som gäller för just installationen. Kör inte sudo brew som genväg: Homebrew avråder från det eftersom kommandot då kan köra kod från installationsprefixet med administratörsbehörighet.
När brew hittas är felet löst
När command -v brew visar en sökväg och brew --version ger ett versionsnummer kan Zsh hitta kommandot igen. Om den ursprungliga uppgiften körs i ett skript eller en app återstår ändå att kontrollera miljön där just den uppgiften startar. För vanliga terminalkommandon är rätt prefix och en startfil som verkligen läses den raka vägen ur felet.