Ortam Değişkenleri:
Windows 10 & 11

Windows'ta Ortam Değişkenleri Nedir?

Ortam değişkenleri, işletim sistemi tarafından depolanan ve programlar, betikler ile kabuğun kendisi tarafından kullanılan yapılandırma bilgilerini tutan adlandırılmış anahtar-değer çiftleridir. Bunları, çalışan herhangi bir işlemin okuyabileceği — yollara veya değerlere doğrudan kod içinde yer vermeden — küresel bir ayarlar deposu olarak düşünebilirsiniz.

Örneğin, çok bilinen PATH değişkeni, Komut İstemi'ne bir komut yazdığınızda Windows'a nereye bakacağını söyler. Her seferinde C:\Windows\System32\notepad.exe yazmak yerine sadece notepad yazarsınız — çünkü C:\Windows\System32 zaten PATH içinde listelenmiştir.

Ortam değişkenleri, Windows NT 3.1'den bu yana Windows'un temel bir parçasıdır ve davranışları Windows 10 ile Windows 11'de neredeyse aynıdır. Grafik arayüz iletişim kutuları Windows 11'in görsel yenilemesi nedeniyle biraz farklı görünse de altta yatan kayıt defteri konumları, miras alma kuralları ve komut satırı araçları tamamen aynı şekilde çalışır.

Ortam değişkenleri neden önemlidir?

Geliştiriciler, sistem yöneticileri ve ileri düzey kullanıcılar ortam değişkenlerine geniş bir yelpazede görevler için güvenir: API anahtarları gibi hassas verileri kaynak kodun dışında saklamak, uygulamaların çalışma zamanı davranışını yeniden derlemeye gerek kalmadan yapılandırmak, herhangi bir makinede çalışan taşınabilir betikler oluşturmak ve Python, Java, Node.js ve Git gibi araçların kurulum yollarını tanımlamak.

Windows'ta Ortam Değişkenlerinin Türleri ve Kapsamları

Windows, ortam değişkenleri için dört farklı kapsam tanır. Kapsamı anlamak kritik öneme sahiptir; çünkü bir düzeyde tanımlanan değişken, başka bir düzeydeki değişkeni geçersiz kılabilir, onun tarafından geçersiz kılınabilir ya da başka bir düzey için görünmez olabilir.

Öncelik sırası ve PATH birleştirme

Çoğu değişken için, her ikisi de aynı adla mevcutsa kullanıcı değişkenleri sistem değişkenlerine göre önceliklidir. Önemli istisna PATH'tir: Windows, sistem PATH'i ile kullanıcı PATH'ini birleştirir (önce sistem, sonra kullanıcı); böylece her ikisi de çalışan herhangi bir işlem tarafından görülen nihai değere katkıda bulunur.

Windows 10 ve Windows 11'de Ortam Değişkenlerini Grafik Arayüz ile Görüntüleme ve Açma

Ortam Değişkenleri iletişim kutusunu açmanın birkaç yolu vardır. Aşağıda, Windows 10 ve Windows 11'de çalışan en güvenilir yöntemler listelenmiştir:

Yöntem A — Sistem Özellikleri üzerinden

1. Win + R tuşlarına basın, sysdm.cpl yazın ve Enter'a basın.
2. Sistem Özellikleri penceresinde Gelişmiş sekmesine tıklayın.
3. Alttaki Ortam Değişkenleri… düğmesine tıklayın.
4. İletişim kutusu iki bölüm gösterir: Kullanıcı değişkenleri (üstte) ve Sistem değişkenleri (altta).

Yöntem B — Ayarlar araması üzerinden (Windows 11)

1. Aramayı açmak için Win + S tuşlarına basın.
2. ortam değişkenleri yazın.
3. İhtiyacınıza göre "Sistem ortam değişkenlerini düzenle" veya "Hesabınız için ortam değişkenlerini düzenleyin" seçeneğine tıklayın.

Yöntem C — Çalıştır iletişim kutusu ile doğrudan komut

1. Çalıştır iletişim kutusunu açmak için Win + R tuşlarına basın.
2. rundll32 sysdm.cpl,EditEnvironmentVariables yazın ve Enter'a basın.
3. Ortam Değişkenleri iletişim kutusu ara adım olmadan doğrudan açılır.

Windows'ta CMD ve PowerShell ile Ortam Değişkenlerini Listeleme

Komut satırı, herhangi bir grafik iletişim kutusu açmadan ortam değişkeni değerlerine hızlı ve betiklenebilir erişim sunar.

Komut İstemi (cmd.exe)

CMD — tüm değişkenleri listelemeset

CMD — belirli bir değişkeni görüntülemeecho %VARIABLE_NAME%
echo %PATH%
echo %USERNAME%

CMD — değişkenleri önek ile filtrelemeset APP_

Argümansız set yazmak, geçerli işlemde mevcut tüm ortam değişkenlerini listeler. set ÖNEK yazmak (eşittir işareti olmadan) adı bu önekle başlayan tüm değişkenleri listeler — JAVA_ veya PYTHON ile ilgili tüm değişkenleri hızla kontrol etmek için çok kullanışlıdır.

PowerShell

PowerShell — tüm değişkenleri listelemeGet-ChildItem Env:

PowerShell — belirli bir değişkeni okuma$env:PATH
$env:USERNAME
$env:APPDATA

PowerShell — filtreleme ve biçimlendirmeGet-ChildItem Env: | Where-Object { $_.Name -like "APP_*" }
Get-ChildItem Env: | Sort-Object Name | Format-Table -AutoSize

PowerShell — kayıt defterinden kalıcı kullanıcı değişkenini okuma[System.Environment]::GetEnvironmentVariable("VARIABLE_NAME", "User")
[System.Environment]::GetEnvironmentVariable("VARIABLE_NAME", "Machine")

Windows'ta Ortam Değişkeni Oluşturma, Düzenleme ve Silme

Yeni değişken oluşturma (grafik arayüz)

1. Ortam Değişkenleri iletişim kutusunu açın (bkz. Bölüm 03).
2. Kullanıcı değişkenleri veya Sistem değişkenleri altında Yeni…'ye tıklayın.
3. Değişken adını (ör. MY_APP_ROOT) ve Değişken değerini (ör. C:\MyApp) girin.
4. Kaydetmek için açık tüm iletişim kutularında Tamam'a tıklayın.

Mevcut bir değişkeni düzenleme (grafik arayüz)

1. Listeden değiştirmek istediğiniz değişkeni seçin.
2. Düzenle…'ye tıklayın.
3. Değeri gerektiği gibi değiştirip Tamam'a tıklayın.

CMD ile değişken oluşturma veya güncelleme (yalnızca geçerli oturum)

CMD — geçerli oturum için değişken ayarlamaset MY_VARIABLE=MerhabaDunya
set APP_ENV=production

CMD — geçerli oturumdan değişken silmeset MY_VARIABLE=

CMD ile değişkeni kalıcı hale getirme (setx)

CMD — kalıcı kullanıcı değişkeni oluşturmasetx MY_VARIABLE "MerhabaDunya"

CMD — kalıcı sistem değişkeni oluşturma (Yönetici gerektirir)setx MY_VARIABLE "MerhabaDunya" /M

Windows 10 ve Windows 11'de PATH Değişkenini Yönetme

PATH değişkeni, tartışmasız en önemli ve en sık değiştirilen ortam değişkenidir. Tam yolunu belirtmeden bir program çalıştırdığınızda Windows'un sırayla aradığı dizinlerin noktalı virgülle ayrılmış listesidir.

Windows 10 ve 11, her girişi kendi satırında gösteren özel bir PATH düzenleyici içerir; bu da ham noktalı virgülle ayrılmış dizeyi elle düzenlemeye kıyasla yönetimi çok daha kolaylaştırır.

PATH düzenleyicisini açma (Windows 10 / 11)

1. Ortam Değişkenleri'ni açın (bkz. Bölüm 03).
2. Kullanıcı veya sistem bölümünde Path'i seçin.
3. Düzenle…'ye tıklayın — Windows, tek bir metin alanı yerine özel çok satırlı bir düzenleyici açar.
4. Girişleri yönetmek için Yeni, Düzenle, Sil, Yukarı Taşı ve Aşağı Taşı düğmelerini kullanın.
5. Tüm iletişim kutularını kaydetmek için Tamam'a tıklayın.

PowerShell ile PATH'e dizin ekleme (kalıcı)

PowerShell — kullanıcı PATH'ine kalıcı olarak ekleme$current = [System.Environment]::GetEnvironmentVariable("Path", "User")
$newEntry = "C:\MyTool\bin"
[System.Environment]::SetEnvironmentVariable("Path", "$current;$newEntry", "User")

PowerShell — sistem PATH'ine ekleme (Yönetici olarak çalıştır)$current = [System.Environment]::GetEnvironmentVariable("Path", "Machine")
$newEntry = "C:\MyTool\bin"
[System.Environment]::SetEnvironmentVariable("Path", "$current;$newEntry", "Machine")

PowerShell ile Gelişmiş Ortam Değişkeni Yönetimi

PowerShell'in [System.Environment] .NET sınıfı ve Env: sağlayıcısı, ortam değişkenlerinin tüm kapsamları üzerinde tam ve betiklenebilir denetim sağlar.

Kalıcı değişkenler ayarlama

PowerShell — kalıcı kullanıcı değişkeni ayarlama[System.Environment]::SetEnvironmentVariable("API_KEY", "abc123xyz", "User")

PowerShell — kalıcı sistem değişkeni ayarlama (Yönetici gerektirir)[System.Environment]::SetEnvironmentVariable("DB_HOST", "prod-db-01", "Machine")

Değişkenleri silme

PowerShell — kullanıcı değişkenini silme[System.Environment]::SetEnvironmentVariable("API_KEY", $null, "User")

İşlem düzeyinde geçici değişken ayarlama

PowerShell — yalnızca geçerli oturum için değişken ayarlama$env:MY_TEMP_VAR = "gecici_deger"
Remove-Item Env:MY_TEMP_VAR

Toplu dışa ve içe aktarma

PowerShell — tüm kullanıcı değişkenlerini dosyaya aktarmaGet-ChildItem Env: | Export-Csv -Path "$HOME\env_backup.csv" -NoTypeInformation

PowerShell — .env dosyasından değişken içe aktarma (yaygın desen)Get-Content ".env" | ForEach-Object {
    if ($_ -match "^([^#=]+)=(.*)$") {
        [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), "User")
    }
}

Windows'taki En Önemli Yerleşik Ortam Değişkenleri

Windows, zengin bir önceden tanımlanmış ortam değişkenleri kümesiyle birlikte gelir. Bunları bilmek zaman kazandırır ve betiklerin farklı makineler ve kullanıcılar arasında taşınabilir olmasını sağlar.

Bu değişkenlerin herhangi birini Dosya Gezgini'nin adres çubuğunda, Çalıştır iletişim kutusunda (Win+R), toplu iş betiklerinde ve PowerShell'de yüzde işaretleriyle çevreleyerek (%DEĞİŞKEN%) veya $env:DEĞİŞKEN söz dizimini kullanarak kullanabilirsiniz.

Windows 10 ve Windows 11'de Ortam Değişkeni Sorunlarını Giderme

Yöntem karşılaştırması

Sık karşılaşılan sorunlar ve çözümleri

Değişiklikler açık uygulamalarda geçerli olmuyor. Ortam değişkeni değişiklikleri yalnızca bir işlem başlatıldığında okunur. Uygulamayı, terminali veya IDE'yi kapatıp yeniden açmanız gerekir. Oturumu kapatıp tekrar açmak, tüm işlemlerin güncellenmiş değerleri almasını sağlar.

PATH'e ekledikten sonra komut bulunamıyor. Önce yeni bir CMD penceresinde echo %PATH% komutuyla yolun doğru eklenip eklenmediğini doğrulayın. Yazım hatalarını, eksik ters eğik çizgileri veya fazladan boşlukları kontrol edin. Doğru kapsamı (kullanıcı veya sistem) düzenleyip düzenlemediğinizden emin olun.

PATH kesilmiş görünüyor — girişler eksik. Bu, eski setx komutunun veya eski kayıt defteri araçlarının 1.024 karakter sınırından kaynaklanır. 32.767 karaktere kadar yol destekleyen grafik PATH düzenleyicisini veya PowerShell'in [System.Environment] yöntemini kullanın (Windows kayıt defteri sınırı).

Sistem değişkenleri geçerli kullanıcı için görünmüyor. Ortam Değişkenleri iletişim kutusundaki hem kullanıcı hem de sistem bölümlerini kontrol edin veya birleşik sonucu gösteren CMD'de set kullanın. Bir sistem değişkeni hâlâ görünmüyorsa Grup İlkesi'ni kontrol edin — değişkenleri geçersiz kılabilir ya da gizleyebilir.

Bir uygulama ortam değişkenini yok sayıyor. Bazı uygulamalar başlangıçta ortam değişkenlerini önbelleğe alır ve çalışma sırasında yeniden okumaz. Uygulamayı yeniden başlatın. Bazıları ayrıca değişkenin, uygulamayı başlatan hizmet başlamadan önce ayarlanmış olmasını gerektirir; bu durumda sistem yeniden başlatması gerekebilir.

Windows Ortam Değişkenleri Hakkında Sıkça Sorulan Sorular