Sorun kabukta değil, uygulamanın ortamında olabilir
macOS’ta terminal içinde
brew,
python,
node ya da GNU araçları doğru çalışıp Finder’dan açılan bir uygulamada aynı komutlar bulunamıyorsa, çoğu zaman sebep kabuğun kendisi değil ortam değişkenlerinin o uygulamaya taşınmamasıdır. Homebrew dokümantasyonu, kurulumdan sonra kabuk yapılandırmasına
brew shellenv eklenmesini ister; aynı belgede, GUI uygulamalarının Homebrew ön ekini varsayılan olarak PATH içine almadığı açıkça belirtilir. Bu yüzden terminalde çalışan bir ayar, masaüstünden açılan bir editörde veya menü çubuğu uygulamasında aynı sonucu vermeyebilir.
Ne zaman bu farkı düşünmelisiniz?
Aşağıdaki durumlarda sorun genellikle PATH farkıdır:
- Terminalde çalışan komut, uygulama içinden çalışmaz.
- Aynı makinede birden fazla
brew kurulum yolu vardır ve uygulama yanlış olanı görür.
-
zshrc içine eklenen ayar, login olmayan bir oturumda yüklenir ama GUI uygulamasına hiç aktarılmaz.
- Sistem araçları ile Homebrew araçları arasında sürüm farkı oluşur.
Apple’ın kabuk kılavuzu, kalıcı değişkenler için login ve non-login kabukların ayrı başlangıç dosyaları kullandığını anlatır. Bu yüzden bir ayarın yalnızca
~/.zshrc içinde olması, her senaryoda yeterli değildir; hangi kabuğun ve hangi oturum türünün açıldığını ayırt etmek gerekir.
Pratik kontrol sırası
Önce terminalde gerçekten neyin yüklendiğini doğrulayın:
-
echo $PATH ile Homebrew dizininin PATH içinde olup olmadığını kontrol edin.
-
command -v brew ile brew komutunun hangi yoldan çözüldüğüne bakın.
-
brew --prefix ile Homebrew’un beklenen ön ekini doğrulayın.
- Finder’dan açılan uygulamada aynı komutların sonuçları farklıysa, uygulamanın kendi ortamı farklıdır.
Homebrew belgeleri, kurulum sonrası
brew shellenv çıktısının kabuk yapılandırmasına eklenmesini önerir; bu, özellikle Apple Silicon sistemlerde
/opt/homebrew/bin yolunun doğru sırada görünmesi için önemlidir. Homebrew ayrıca bazı durumlarda kurulum yolunun kabuğa açıkça tanıtılmasını ister; bu nedenle “kurulu ama bulunamıyor” hissi çoğu kez eksik shellenv ayarından kaynaklanır.
Sık yapılan hata
En yaygın hata, sorunu “GNU araçları bozuk” diye okumaktır. Oysa sorun çoğu kez araçların kendisi değil, onları hangi oturumun gördüğüdür. Terminal içinde doğru çalışan bir ayar, grafik uygulamalarda otomatik olarak geçerli olmayabilir. Aynı şekilde,
~/.zshrc içine yazılan satırın çalışması, login kabuğu ile açılan oturumda aynı etkiyi garanti etmez. Apple’ın dokümanı bu ayrımı açıkça yapar.
GNU araçları açısından neden önemli?
GNU coreutils belgeleri, araçların davranışının sürüme ve çevresel koşullara bağlı olarak değişebileceğini gösterir. Örneğin
tail bazı dosya sistemlerinde tanınmayan tür uyarısı verip polling’e dönebilir; bu, aracın bozuk olduğu anlamına gelmez, çoğu zaman sürüm veya ortam farkına işaret eder. macOS’ta Homebrew ile kurulan GNU araçlarını kullanırken de doğru PATH ve doğru ön ek seçimi, beklenmedik davranışları ayıklamanın ilk adımıdır.
En güvenli yaklaşım
Tek cümlelik kural şu: terminal için yapılan ayar ile GUI uygulamaları için gerekli ortam aynı şey değildir. Eğer amaç Homebrew ve GNU araçlarını her yerde tutarlı kullanmaksa, önce hangi oturumun hangi başlangıç dosyasını okuduğunu, sonra da uygulamanın PATH mirasını kontrol edin. Sorun bu iki katmandan birinde çıkar; ikisini ayırmak, yanlış çözüm denemelerini azaltır.
