Ulaşım
- Adres:Batıkent Mh. 8910 Sk. 6. Etap 1H No: 18 Yeni Toki Eyyübiye / Şanlıurfa (Yeni Alım Satım Karşısı)
- Telefon:0 (545) 528 88 93
- eMail: info@alestaweb.com
Terminalinizde "zsh: command not found" (zsh komut bulunamadı hatası) mı alıyorsunuz? Kurulu programları çalıştıramıyor musunuz? Hiç endişelenmeyin! Alesta Web olarak bu shell error'ü 10 dakikada çözmenize yardımcı olacağız. macOS ve Linux'ta en sık karşılaşılan terminal hatalarından birini adım adım çözeceğiz (step by step solution).
Terminal'de bir komut yazdığınızda "zsh: command not found" hatası (command not found error), shell'in yazdığınız komutu bulamadığı anlamına gelir. Bu durumda terminal şunu der: "Aradım ama bu programı bulamadım."
zsh: command not found: python zsh: command not found: brew zsh: command not found: code zsh: command not found: npm
Bu hatalar programın kurulu olmadığı ya da PATH'te kayıtlı olmadığı anlamına gelir (program is not in PATH).
Alesta Web olarak binlerce kullanıcının bu sorununu çözdük. Deneyimlerimize göre %90 oranında sebep PATH ayarlarındaki eksiklik (missing PATH configuration).
PATH, işletim sisteminin yürütülebilir programları aradığı dizinlerin listesidir (list of directories where shell looks for programs). Basitçe söylemek gerekirse:
Şöyle düşünün: PATH bir telefon rehberi gibi. Eğer bir isim rehberde yoksa, onu arayamazsınız. Aynı şekilde program PATH'te yoksa, terminal onu çalıştıramaz (if program is not in PATH, terminal can't run it).
macOS'ta varsayılan PATH genelde şu dizinleri içerir: /usr/local/bin, /usr/bin, /bin, /usr/sbin, /sbin. Apple Silicon Mac'lerde (M1, M2, M3, M4) Homebrew için /opt/homebrew/bin de eklenir.
İlk olarak mevcut PATH ayarlarınızı kontrol edin (check your current PATH settings):
echo $PATH
Bu komut PATH içindeki tüm dizinleri gösterir. Çıktı şuna benzer:
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin
Eğer aradığınız program bir dizinde kurulu ama o dizin PATH'te yoksa, işte sorun budur! Alesta Web olarak en sık gördüğümüz eksik dizinler (most common missing directories):
/opt/homebrew/bin (macOS Apple Silicon için Homebrew)$HOME/.local/bin (Python pip user install)$HOME/bin (kullanıcı özel programlar)/Applications/Visual Studio Code.app/Contents/Resources/app/bin (VS Code CLI)En yaygın ve kalıcı çözüm .zshrc dosyasına PATH eklemektir (add PATH to .zshrc file). Bu dosya her terminal açıldığında otomatik çalışır.
nano ~/.zshrc
Eğer dosya yoksa otomatik oluşturulur (file will be created automatically if it doesn't exist).
Dosyanın en altına şu satırı ekleyin (add this line to the bottom):
export PATH="$PATH:/yeni/dizin/yolu"
Örnek PATH eklemeleri / Example PATH additions:
# Homebrew (Apple Silicon Mac) export PATH="/opt/homebrew/bin:$PATH" # Python pip kullanıcı kurulumları export PATH="$HOME/.local/bin:$PATH" # VS Code komut satırı export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin" # Node.js global paketler export PATH="$HOME/.npm-global/bin:$PATH"
Nano editörde:
Ctrl + O tuşuna basın (kaydet / save)Enter tuşuna basın (onayla / confirm)Ctrl + X tuşuna basın (çık / exit)source ~/.zshrc
Bu komut .zshrc dosyasını yeniden yükler. Terminal'i yeniden başlatmanıza gerek kalmaz (no need to restart terminal).
Komutunuzu tekrar deneyin. Artık "command not found" hatası almamalısınız! Alesta Web olarak bu yöntemin %95 başarı oranı olduğunu gözlemledik.
macOS'ta Homebrew kullanıyorsanız ve "brew: command not found" alıyorsanız, işte özel çözüm (special solution for Homebrew):
Intel Mac ile Apple Silicon Mac'lerde (M1/M2/M3/M4) Homebrew farklı dizinlere kurulur!
/usr/local/bin/brew/opt/homebrew/bin/brewHomebrew'un kendi yapılandırma komutunu çalıştırın (run Homebrew's configuration command):
# Apple Silicon Mac için echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc eval "$(/opt/homebrew/bin/brew shellenv)" # Intel Mac için echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zshrc eval "$(/usr/local/bin/brew shellenv)"
Bu komutlar PATH'i otomatik olarak yapılandırır (automatically configure PATH).
alestaweb.com'da Homebrew ile ilgili daha fazla rehber bulabilirsiniz.
"python: command not found" ya da "pip: command not found" hatası alıyorsanız, Python PATH'e eklenmemiş olabilir (Python may not be in PATH).
# Python 3.x için export PATH="$HOME/Library/Python/3.x/bin:$PATH" # pip kullanıcı kurulumları için export PATH="$HOME/.local/bin:$PATH"
Bu satırları ~/.zshrc dosyasına ekleyin.
python3 --version which python3
İkinci komut Python'un tam yolunu gösterir (shows full path of Python).
Alesta Web ekibi olarak Python kurulum sorunlarında yardımcı olmak için detaylı rehberler hazırladık. alestaweb.com'u ziyaret edin.
Eğer sadece bir kez kullanmak için PATH eklemek istiyorsanız, terminal'de doğrudan çalıştırın (run directly in terminal for one-time use):
export PATH="$PATH:/eklenmesini/istediginiz/dizin"
Önemli: Bu yöntem terminal kapatıldığında kaybolur! Kalıcı yapmak için .zshrc'ye ekleyin (this method is lost when terminal closes - add to .zshrc for permanent).
zsh: permission denied: /usr/local/bin/program
Çözüm / Solution:
chmod +x /usr/local/bin/program
Bu komut dosyaya çalıştırma izni verir (grants execute permission to file).
Çözüm / Solution:
# Dosyayı oluştur (eğer yoksa) touch ~/.zshrc # Sonra düzenle nano ~/.zshrc
Alesta Web İpucu: Yanlış dosyaya eklemiş olabilirsiniz. Kontrol edin (you may have added to wrong file - check):
~/.zshrc → zsh için doğru dosya (correct file for zsh)~/.bash_profile veya ~/.bashrc → bash için (for bash, not zsh)macOS'ta varsayılan shell zsh'dir (default shell in macOS is zsh since Catalina).
Bu makalede kullanılan bilgiler aşağıdaki güvenilir kaynaklardan alınmıştır (information used in this article is from the following reliable sources):
Alesta Web olarak tüm bilgileri doğruladık ve macOS Sonoma, Linux Ubuntu 24.04 sistemlerinde test ettik (we verified and tested all information on macOS and Linux systems).
Artık "zsh: command not found" hatası (zsh command not found error) geride kaldı. Terminal'inizde tüm komutları sorunsuz çalıştırabilirsiniz! Alesta Web olarak shell configuration sorunlarında her zaman yanınızdayız.
Hızlı Özet / Quick Summary:
Faydalı Linkler / Useful Links:
Bu rehber hakkında sorularınız mı var (do you have questions about this guide)? Alesta Web ekibi size yardımcı olmaya hazır! alestaweb.com üzerinden bizimle iletişime geçebilirsiniz.
© 2026 AlestaWeb - Tüm hakları saklıdır. Bu makale Alesta Web tarafından hazırlanmıştır.