Komut satırından Microsoft C++ Derleme Araçları'nı kullanma

Visual Studio dahil edilen araçları kullanarak komut satırında C ve C++ uygulamaları oluşturabilirsiniz. ayrıca Microsoft C++ (MSVC) Derleme Araçları'nı tek başına paket olarak da indirebilirsiniz. Kullanmayı planlamıyorsanız Visual Studio IDE yüklemeniz gerekmez.

Not

Bu makale, tek tek derleyicileri, bağlayıcıları, kitaplıkları ve diğer temel araçları kullanacak bir ortam ayarlama hakkındadır. Visual Studio'daki yerel proje derleme sistemi, MSBuild'i temel alarak bu makalede açıklandığı gibi ortamı kullanmaz. Komut satırından MSBuild'i kullanma hakkında daha fazla bilgi için, C++ komut satırındaki MSBuild'e bakın.

Araçları indirme ve yükleme

Visual Studio ve bir C++ iş yükü yüklediyseniz, tüm komut satırı araçlarına sahipsinizdir. C++ ve Visual Studio yükleme hakkında bilgi için bkz. Visual Studio'da C++ desteğini yükleme.

Yalnızca komut satırı araçlarını istiyorsanız, Build Tools for Visual Studio'yu indirin. İndirmeler sayfasında, Derleme Araçları indirme bağlantısını bulmak için Tools for Visual Studio bölümünü genişletin. İndirilen yürütülebilir dosyayı çalıştırdığınızda, Visual Studio Yükleyicisi'ni güncelleştirir ve çalıştırır.

Yalnızca C++ geliştirme için ihtiyacınız olan araçları yüklemek için C++ ile masaüstü geliştirme iş yükünü seçin. Yükleme ayrıntıları'nın altında isteğe bağlı kitaplıkları ve araç kümelerini seçebilirsiniz. Visual Studio 2015, Visual Studio 2017 veya Visual Studio 2019 araç kümelerini kullanarak kod oluşturmak için isteğe bağlı MSVC v140, v141 veya v142 derleme araçlarını seçin. Seçimlerinizden memnun olduğunuzda Yükle'yi seçin.

Komut satırı araçlarını kullanma

Visual Studio Yükleyicisi'nde C++ iş yüklerinden birini seçtiğinizde, msvc derleme araçları paketinin belirli bir sürümünü varsayılan olarak yükler. Visual Studio 2022 ve öncesi için paket, belirli bir Visual Studio sürümü için tüm C ve C++ araçlarını içeren platform araç takımı (v### sürüm biçimi) tarafından düzenlenir. Visual Studio'in sonraki sürümleri için paket, söz konusu MSVC paketi için tüm C ve C++ araçlarını içeren MSVC sürümünden (v##.## sürüm biçimi) oluşur. MSVC sürümü Visual Studio sürümünden ayrılmıştır.

Araçlar arasında C/C++ derleyicileri, bağlayıcılar, derleyiciler ve diğer derleme araçları bulunur. Uyumlu kitaplıkları ve başlık dosyalarını içerir. Bu araçların tümünü komut satırında kullanabilirsiniz. Visual Studio IDE bunları dahili olarak kullanır. x86, x64, ARM ve ARM64 hedefleri için kod oluşturan, x86 üzerinde barındırılan ve x64 üzerinde barındırılan ayrı derleyiciler ve araçlar vardır. Belirli bir konak ve hedef derleme mimarisi için her araç kümesi kendi dizininde depolanır.

Araçların düzgün çalışması için birkaç ortam değişkeninin ayarlanması gerekir. Bu değişkenler araçları PATH’e ekler ve include dosyalarının, kitaplık dosyalarının ve SDK’ların konumlarını ayarlar. Yükleyici, bu ortam değişkenlerini ayarlamayı kolaylaştırmak için yükleme sırasında özelleştirilmiş komut dosyaları veya toplu iş dosyaları oluşturur. Belirli bir konak ve hedef derleme mimarisi, Windows SDK sürümü ve platform araç takımı ayarlamak için bu komut dosyalarından birini çalıştırabilirsiniz.

Kolaylık sağlamak için yükleyici, Başlat menüsü'nizde kısayollar da oluşturur. Kısayollar, belirli konak ve hedef birleşimleri için bu komut dosyalarını kullanarak geliştirici Komut İstemi pencerelerini açar. Bu kısayollar tüm gerekli ortam değişkenlerinin ayarlandığından ve kullanıma hazır olduğundan emin olur.

Gerekli ortam değişkenleri, yüklemenize ve seçtiğiniz derleme mimarisine özeldir. Ürün güncelleştirmeleri veya yükseltmeleri değişkenleri değiştirebilir. Bu değişkenlik, ortam değişkenlerini kendiniz ayarlamak yerine yüklü bir komut istemi kısayolunu veya komut dosyasını tercih etmenizi önermemizin nedenlerinden biridir.

Yükleyicinin eklediği araç kümeleri, komut dosyaları ve kısayollar, bilgisayar işlemcinize ve yükleme sırasında seçtiğiniz seçeneklere bağlıdır. x86 ve x64 kodu oluşturan, x86 üzerinde barındırılan araçlar ve çapraz araçlar her zaman yüklenir. 64 bit Windows kullanıyorsanız, x86 ve x64 kodunu oluşturan x64 için barındırılan araçlar ve çapraz platform araçları da yüklenir. İsteğe bağlı C++ Evrensel Windows Platformu araçlarını seçerseniz ARM ve ARM64 kodu oluşturan x86 ve x64 araçları da yüklenir. Diğer iş yükleri bu araçları yükleyebilir.

Komut satırı derlemeleri için yol ve ortam değişkenleri

MSVC komut satırı araçları , , PATHTMP, , INCLUDEve LIB ortam değişkenlerini kullanırLIBPATH. Ayrıca, yüklü araçlarınıza, platformlarınıza ve SDK'larınıza özgü diğer ortam değişkenlerini de kullanırlar. Basit bir Visual Studio yüklemesi bile yirmi veya daha fazla ortam değişkeni ayarlayabilir. Bu karmaşıklık, bir geliştirici komut istemi kısayolu veya özelleştirilmiş komut dosyalarından birini kullanmanızı kesinlikle öneririz. Bu değişkenleri Windows ortamında kendiniz ayarlamanız önerilmez.

Bir geliştirici komut istemi kısayolunun hangi ortam değişkenlerini ayarladığını görmek için SET komutunu kullanın. Normal bir Komut İstemi penceresi açın ve temel almak için SET komutunun çıktısını yakalayın. Bir geliştirici Komut İstemi penceresi açın ve karşılaştırma için komutun çıkışını yakalayın SET . Geliştirici komut istemi tarafından ayarlanan ortam değişkenlerini vurgulamak için Visual Studio yerleşik aracı gibi bir fark aracı kullanın. Derleyici ve bağlayıcı ortam değişkenleri hakkında daha fazla bilgi için bkz . CL ortam değişkenleri.

Geliştirici komut istemi kısayolları

Komut istemi kısayolları, Windows Başlat menünüzün sürüme özgü Visual Studio klasörüne yüklenir. Temel komut istemi kısayollarının ve destekledikleri derleme mimarilerinin listesi aşağıdadır:

• Geliştirici Komut İstemi. Ortamı, 32 bit, x86 yerel kod oluşturmak için 32 bit x86 yerel araçları kullanacak şekilde ayarlar.
• x86 Yerel Araçlar Komut İstemi. Ortamı, 32 bit, x86 yerel kod oluşturmak için 32 bit x86 yerel araçları kullanacak şekilde ayarlar.
• x64 Yerel Araçlar Komut İstemi. 64 bitlik, x64’e özgü kod oluşturmak için ortamı 64 bitlik, x64’e özgü araçları kullanacak şekilde ayarlar.
• x86_x64 Çapraz Araçlar Komut İstemi. Ortamı, 64 bitlik x64 yerel kod oluşturmak için 32 bitlik x86 yerel araçları kullanmak üzere ayarlar.
• x64_x86 Çapraz Araçlar Komut İstemi. Ortamı, 32 bitlik x86’a özgü kod oluşturmak üzere 64 bitlik x64’e özgü araçları kullanacak şekilde ayarlar.

Başlat menüsü klasörü ve kısayol adları, Visual Studio yüklü sürümüne bağlı olarak değişir. Eğer bir tane ayarlarsanız, bunlar aynı zamanda Kurulum Takma Adına bağlı olur. Örneğin, Visual Studio 2022'yi yüklediğinizi ve ona Latest takma adı taktığınızı varsayalım. Geliştirici komut istemi kısayolu, Visual Studio 2022 adlı klasörde VS 2022 (En Son) için Geldirici Komut İstemi olarak adlandırılır.

Not

Çeşitli komut satırı araçları veya araç seçenekleri Yönetici ayrıcalıkları gerektirir. Bunları kullanırken izin sorunlarınız varsa, Yönetici Olarak Çalıştır seçeneğini kullanarak geliştirici Komut İstemi penceresini açmanızı öneririz. Komut İstemi penceresinin kısayol menüsünü açmak için sağ tıklayın, ardından Diğer>Yönetici olarak çalıştır'ı seçin.

Geliştirici Komut İstemi penceresini açmak için

1. Masaüstünde Windows Start menüsünü açın. Windows 11'da yüklü uygulamaların listesini açmak için Tüm uygulamalar öğesini seçin. Windows 10'da liste sol tarafta açık. Visual Studio 2022 gibi Visual Studio sürümünüz için klasörü (uygulamayı değil) bulmak ve açmak için listeyi aşağı kaydırın.

2. klasöründe, Visual Studio sürümünüz için Geldirici Komut İstemi seçin. Bu kısayol, 32 bit x86 yerel kod derlemek için 32 bit x86 yerel araçların varsayılan derleme mimarisini kullanan bir geliştirici Komut İstemi penceresi başlatır. Varsayılan olmayan bir derleme mimarisini tercih ediyorsanız, konak ve hedef mimariyi belirtmek için yerel ya da çapraz araç komut istemlerinden birini seçin.

Geliştirici komut istemini açmanın daha hızlı bir yolu için, masaüstü arama kutusuna geliştirici komut istemi girin. Ardından istediğiniz sonucu seçin.

Not

Varsayılan olarak, geliştirici komut istemindeki geçerli çalışma dizini, Program Files dizinindeki Visual Studio yüklemenizin köküdür. Bu konum kodunuz ve projeleriniz için uygun değildir. Proje oluşturmadan önce geçerli çalışma dizinini başka bir konuma değiştirin. IDE, genellikle %USERPROFILE%\source\repos içinde kullanıcı dizininizde projeler oluşturur.

Geliştirici komut dosyası konumları

Derleme ortamını mevcut bir Komut İstemi penceresinde ayarlamayı tercih ederseniz, yükleyici tarafından oluşturulan komut dosyalarından birini kullanabilirsiniz. Ortamı yeni bir Komut İstemi penceresinde ayarlamanızı öneririz. Daha sonra aynı komut penceresinde ortamları değiştirmenizi önermiyoruz.

Komut dosyası konumu, yüklediğiniz Visual Studio sürümüne ve yükleme sırasında yaptığınız seçimlere bağlıdır. Visual Studio 2022 için, 64 bit sistemdeki tipik yükleme konumu \Program Files\Microsoft Visual Studio\2022\<edition> içindedir. <edition>, Community, Professional, Enterprise, BuildTools veya belirttiğiniz başka bir takma ad olabilir.

Birincil geliştirici komut istemi komut dosyası, VsDevCmd.batdizininde Common7\Tools bulunur. Parametreleri belirtmediğinizde, ortamı 32 bit x86 kodu oluşturmak için x86 yerel araçlarını kullanacak şekilde ayarlar.

Belirli derleme mimarilerini ayarlamak için daha fazla komut dosyası kullanılabilir. Kullanılabilir komut dosyaları, yüklediğiniz Visual Studio iş yüklerine ve seçeneklere bağlıdır. Visual Studio 2017 ve Visual Studio 2019'da bunları VC\Auxiliary\Build dizininde bulabilirsiniz.

Bu komut dosyaları varsayılan parametreleri ayarlar ve belirtilen derleme mimarisi ortamını ayarlamak için çağrısı VsDevCmd.bat yapar. Tipik bir yükleme şu komut dosyalarını içerebilir:

Komut Dosyası	Ana bilgisayar ve hedef mimariler
vcvars32.bat	32 bit x86 kodu oluşturmak için 32 bit x86 yerel araçlarını kullanın.
vcvars64.bat	64 bit x64 kodu oluşturmak için 64 bit x64 yerel araçlarını kullanın.
vcvarsx86_amd64.bat	64 bit x64 kodu oluşturmak için 32 bit x86 yerel çapraz araçlarını kullanın.
vcvarsamd64_x86.bat	32 bit x86 kodu oluşturmak için 64 bit x64 yerel çapraz araçlarını kullanın.
vcvarsx86_arm.bat	ARM kodu oluşturmak için 32 bit x86 yerel çapraz araçlarını kullanın.
vcvarsamd64_arm.bat	ARM kodu oluşturmak için 64 bit x64 yerel çapraz araçlarını kullanın.
vcvarsx86_arm64.bat	ARM64 kodu oluşturmak için 32 bit x86 yerel çapraz araçlarını kullanın.
vcvarsamd64_arm64.bat	ARM64 kodu oluşturmak için 64 bit x64 yerel çapraz araçlarını kullanın.
vcvarsall.bat	Ana bilgisayar ve hedef mimarileri, Windows SDK ve platform seçeneklerini belirtmek için parametreleri kullanın. Desteklenen seçeneklerin listesi için parametresini /help kullanarak çağrısı yapın.

Dikkat

vcvarsall.bat dosyası ve diğer Visual Studio komut dosyaları bilgisayardan bilgisayara farklılık gösterebilir. Eksik veya zarar görmüş vcvarsall.bat bir dosyayı başka bir bilgisayardan dosya kullanarak değiştirmeyin. Eksik dosyayı değiştirmek için Visual Studio yükleyicisini yeniden çalıştırın.

Dosya vcvarsall.bat , sürümden sürüme de değişir. Visual Studio'nin geçerli sürümü, Visual Studio önceki bir sürümüne sahip bir bilgisayara yüklenmişse, aynı Komut İstemi penceresinde farklı sürümlerden vcvarsall.bat veya başka bir Visual Studio komut dosyasını çalıştırmayın.

Var olan bir komut penceresinde geliştirici araçlarını kullanma

Var olan bir komut penceresinde belirli bir derleme mimarisini belirtmenin vcvarsall.bat en basit yolu, dosyayı kullanmaktır. Komut İstemi penceresini yerel 32 bit veya 64 bit derleme için yapılandırmak üzere ortam değişkenlerini ayarlamak için kullanın vcvarsall.bat . Bağımsız değişkenler x86, x64, ARM veya ARM64 işlemcileri için çapraz derleme belirtmenize olanak sağlar. Microsoft Store, Evrensel Windows Platformu veya Windows Masaüstü platformlarını hedefleyebilirsiniz. Hatta hangi Windows SDK'nın kullanılacağını belirtebilir ve platform araç takımı sürümünü seçebilirsiniz.

vcvarsall.bat öğesini bağımsız değişken verilmeden kullandığınızda, ortam değişkenlerini 32 bit Windows Masaüstü hedefleri için mevcut x86 yerel derleyicisini kullanacak şekilde yapılandırır. Ortamı, yerel veya çapraz derleyici araçlarından herhangi birini kullanacak şekilde yapılandırmak için argümanlar ekleyin. vcvarsall.bat yüklü olmayan veya bilgisayarınızda bulunmayan bir yapılandırma belirtirseniz bir hata iletisi görüntüler.

vcvarsall söz dizimi

vcvarsall.bat [architecture] [platform_type] [winsdk_version] [-vcvars_ver=vcversion] [spectre_mode]

• architecture

  Bu isteğe bağlı bağımsız değişken, kullanılacak konak ve hedef mimariyi belirtir. architecture belirtmezseniz, varsayılan derleme ortamı kullanılır. Aşağıdaki argümanlar desteklenmektedir:

  architecture	Derleyici	Ana bilgisayar mimarisi	Yapı çıktısı (hedef) mimarisi
  x86	x86 32-bit yerel	x86, x64	x86
  x86_amd64 veya x86_x64	x64'in x86 üzerinde çalışması	x86, x64	x64
  x86_arm	x86 mimari üzerinde ARM	x86, x64	KOL
  x86_arm64	x86 çapraz üzerinde ARM64	x86, x64	ARM64
  amd64 veya x64	x64 64 bit yerel	x64	x64
  amd64_x86 veya x64_x86	x64 üzerinde x86 uyumu	x64	x86
  amd64_arm veya x64_arm	x64 sistemde ARM uyumluluğu	x64	KOL
  amd64_arm64 veya x64_arm64	x64 çapraz üzerinde ARM64	x64	ARM64

• platform_type

  Bu isteğe bağlı argüman, platform türü olarak store veya uwp belirtir. Varsayılan olarak, ortam masaüstü veya konsol uygulamaları derlemek için ayarlanır.

• winsdk_version

  İsteğe bağlı olarak, kullanılacak Windows SDK sürümünü belirtir. Varsayılan olarak, en son yüklenen Windows SDK kullanılır. Windows SDK sürümünü belirtmek için 10.0.10240.0 gibi tam bir Windows SDK numarası kullanın veya Windows 8.1 SDK'sını kullanmak için 8.1 belirtin.

• vcversion

  İsteğe bağlı olarak, kullanılacak Visual Studio derleyici araç takımını belirtir. Varsayılan olarak, ortam geçerli Visual Studio derleyici araç takımını kullanacak şekilde ayarlanır.

  -vcvars_ver=14.2x.yy kullanarak Visual Studio 2019 derleyici araç takımının belirli bir sürümünü belirtin.

  Visual Studio 2019 derleyici araç takımının en son sürümünü belirtmek için -vcvars_ver=14.29 kullanın.

  -vcvars_ver=14.0 kullanarak Visual Studio 2015 derleyici araç takımını belirtin.

• spectre_mode

  Spectre azaltmaları olmadan kitaplıkları kullanmak için bu parametreyi hariç tutun. Spectre azaltmaları olan kitaplıkları kullanmak için değer olarak spectre kullanın.

Derleme ortamını var olan bir Komut İstemi penceresinde ayarlamak için

1. Komut isteminde CD komutunu kullanarak Visual Studio yükleme dizinine geçin. Ardından yeniden kullanarak CD yapılandırmaya özgü komut dosyalarını içeren alt dizine geçin. Visual Studio 2019 ve Visual Studio 2017 için VC\Auxiliary\Build alt dizinini kullanın. Visual Studio 2015 için VC alt dizinini kullanın.

2. Tercih ettiğiniz geliştirici ortamı için komutunu girin. Örneğin, en son Windows SDK'sını ve Visual Studio derleyici araç takımını kullanarak 64 bit platformda UWP için ARM kodu oluşturmak için şu komutu kullanın:

   vcvarsall.bat amd64_arm uwp
   

Kendi komut istemi kısayolunuzu oluşturma

Kullanılan komut hedefini görmek için geliştirici komut istemi kısayolu için Özellikler iletişim kutusunu açın. Örneğin, VS 2019 için x64 Yerel Araçlar Komut İstemi kısayolunun hedefi şuna benzer:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

Mimariye özgü toplu iş dosyaları architecture parametresini ayarlar ve vcvarsall.bat fonksiyonunu çağırır. Bu toplu iş dosyalarına, vcvarsall.bat öğesine geçirdiğiniz seçeneklerin aynısını geçirebilir veya doğrudan vcvarsall.bat çağırabilirsiniz. Kendi komut kısayolunuzun parametrelerini belirtmek için, bunları çift tırnak içinde komutun sonuna ekleyin. Örneğin, en son Windows SDK'sını kullanarak 64 bit platformda UWP için ARM kodu oluşturmaya yönelik bir kısayol aşağıda verilmiştır. Önceki bir derleyici araç takımını kullanmak için sürüm numarasını belirtin. Kısayolunuzda şu komut hedefi gibi bir komut kullanın:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29

yolu Visual Studio yükleme dizininizi yansıtacak şekilde ayarlayın. Dosyada vcvarsall.bat belirli sürüm numaraları hakkında ek bilgiler bulunur.

Komut satırı araçları

Komut isteminde C/C++ projesi oluşturmak için Visual Studio şu komut satırı araçlarını sağlar:

• CL

  Kaynak kod dosyalarını derlemek ve uygulamalara, kitaplıklara ve DLL'lere bağlamak için derleyiciyi (cl.exe) kullanın.

• Link

  Derlenmiş nesne dosyalarını ve kitaplıklarını uygulamalara ve DLL'lere bağlamak için bağlayıcıyı (link.exe) kullanın.

Komut satırında derleme yaptığınızda, anlık yardım için F1 komutu kullanılamaz. Bunun yerine, uyarılar, hatalar ve iletiler hakkında bilgi almak için bir arama altyapısı kullanabilirsiniz. Çevrimdışı yardım dosyalarını da indirebilir ve kullanabilirsiniz. Microsoft Learn'de aramayı kullanmak için, herhangi bir makalenin üst kısmındaki arama kutusuna sorgunuzu girin.

Komut satırı proje yönetim araçları

varsayılan olarak, Visual Studio IDE MSBuild tabanlı yerel proje derleme sistemlerini kullanır. IDE kullanmadan proje derlemek için MSBuild'i doğrudan çağırabilirsiniz. Proje ve çözüm oluşturmak için Visual Studio kullanmak için devenv komutunu da kullanabilirsiniz. Visual Studio, CMake veya NMake tabanlı derleme sistemlerini de destekler.

• MSBuild

  Derlemeyi yapılandırmak ve Visual Studio IDE yüklemeden araç takımını çağırmak için MSBuild (msbuild.exe) ve proje dosyası (.vcxproj) kullanın. Visual Studio IDE Build projesini veya Build Çözümü komutunu çalıştırmaya eşdeğerdir. MSBuild, komut satırında derleme yaparken IDE'ye göre avantajlara sahiptir. Tüm derleme sunucularınıza ve derleme işlem hatlarınıza tam IDE yüklemeniz gerekmez. IDE'nin ek yükünden kaçınırsınız. MSBuild kapsayıcılı derleme ortamlarında çalışır ve bir ikili günlük kaydedici destekler.

• DEVENV

  Visual Studio IDE görüntülemeden belirli derleme komutlarını yürütmek için devenv.exe veya /Build gibi bir komut satırı anahtarıyla birlikte DEVENV (/Clean) kullanın.

• CMake

  CMake (cmake.exe), birden çok platformda çalışan derleme işlemlerini tanımlamaya yönelik platformlar arası bir açık kaynak aracıdır. CMake, MSBuild ve Make gibi desteklenen platformları için yerel derleme araçlarını yapılandırabilir ve denetleyebilir. CMake hakkında daha fazla bilgi için CMake belgelerine bakın.

• NMAKE

  Geleneksel bir derleme dosyası kullanarak C++ projeleri derlemek için NMAKE (nmake.exe) kullanın.

Not

Visual Studio 2019 sürüm 16.5'den itibaren MSBuild ve DEVENV, kullanılan araç takımını ve kitaplıkları denetlemek için komut satırı ortamını kullanmaz.

Ayrıca bkz.

• İzlenecek yol: Komut satırında yerel bir C++ programı derleme
• İzlenecek Yol: Komut satırında C programı derleme
• İzlenecek yol: Komut satırında bir C++/CLI programı derleme
• İzlenecek yol: Komut satırında bir C++/CX programı derleme
• Projeler ve derleme sistemleri
• /MD, /MT, /LD (Çalışma zamanı kitaplığını kullan)
• C/C++ derleyici seçenekleri
• MSVC bağlayıcı seçenekleri
• Ek MSVC derleme araçları