Použití nástrojů sestavení Microsoft C++ z příkazového řádku

Aplikace jazyka C a C++ můžete vytvářet na příkazovém řádku pomocí nástrojů, které jsou součástí Visual Studio. Nástroje sestavení Microsoft C++ (MSVC) jsou také ke stažení jako samostatný balíček. Pokud ho nechcete používat, nemusíte instalovat Visual Studio – sada IDE.

Poznámka:

Tento článek popisuje, jak nastavit prostředí tak, aby používalo jednotlivé kompilátory, linkery, knihovníka a další základní nástroje. Nativní systém sestavení projektu v Visual Studio založený na nástroji MSBuild nepoužívá prostředí, jak je popsáno v tomto článku. Další informace o použití nástroje MSBuild z příkazového řádku naleznete v nástroji MSBuild na příkazovém řádku – C++.

Stažení a instalace nástrojů

Pokud jste nainstalovali Visual Studio a úlohu C++, máte všechny nástroje příkazového řádku. Informace o tom, jak nainstalovat C++ a Visual Studio, najdete v tématu Podpora instalačního jazyka C++ v Visual Studio. Pokud chcete jenom sadu nástrojů příkazového řádku, stáhněte si nástroje Build Tools for Visual Studio. Na stránce pro stahování rozbalte oddíl Nástroje pro Visual Studio a vyhledejte nástroj sestavení ke stažení. Když spustíte stažený spustitelný soubor, aktualizuje se a spustí instalační program Visual Studio. Pokud chcete nainstalovat jenom nástroje, které potřebujete pro vývoj v jazyce C++, vyberte vývoj desktopových aplikací pomocí úlohy C++ . Můžete vybrat volitelné knihovny a sady nástrojů, které chcete zahrnout do podrobností o instalaci. Pokud chcete sestavit kód pomocí sad nástrojů Visual Studio 2015, 2017 nebo 2019, vyberte volitelné nástroje sestavení MSVC v140, v141 nebo v142. Až budete s výběrem spokojeni, zvolte Nainstalovat.

Jak používat nástroje příkazového řádku

Když zvolíte jednu z úloh C++ v instalačním programu Visual Studio, ve výchozím nastavení nainstaluje konkrétní verzi balíčku MSVC Build Tools. Pro Visual Studio 2022 a starší je to uspořádané pomocí sady nástrojů platform toolset (ve formátu verze v###), která obsahuje všechny nástroje jazyka C a C++ pro konkrétní verzi Visual Studio. Pro Visual Studio 2026 a novější se skládá z verze MSVC (ve formátu verze v##.##), která obsahuje všechny nástroje jazyka C a C++ pro tento konkrétní balíček MSVC. Verze MSVC je oddělená od verze Visual Studio. Mezi tyto nástroje patří kompilátory C/C++, linkery, assemblery a další nástroje sestavení a odpovídající knihovny a soubory hlaviček. Všechny tyto nástroje můžete použít na příkazovém řádku. Visual Studio – sada IDE je také interně používá. Existují samostatné kompilátory a nástroje hostované na platformě x86 a x64, které sestavují kód pro cíle x86, x64, ARM a ARM64. Každá sada nástrojů pro konkrétní architekturu sestavení hostitelského a cílového prostředí je uložena ve svém vlastním adresáři.

Aby nástroje fungovaly správně, vyžadují nastavení několika konkrétních proměnných prostředí. Tyto proměnné slouží k přidání nástrojů do systémové cesty a k nastavení umístění zahrnutých souborů, knihovních souborů a sad SDK. Aby bylo možné tyto proměnné prostředí snadno nastavit, instalační program během instalace vytvoří přizpůsobené soubory příkazů nebo dávkové soubory. Můžete spustit jeden z těchto souborů příkazů a nastavit konkrétní architekturu sestavení hostitele a cíle, Windows verzi sady SDK a sadu nástrojů platformy. Pro vaše pohodlí instalátor také vytvoří zástupce ve vaší nabídce Start. Klávesové zkratky otevřou okna příkazového řádku vývojáře pomocí těchto souborů příkazů pro konkrétní kombinace hostitele a cíle. Tyto klávesové zkratky zajišťují, že jsou všechny požadované proměnné prostředí nastavené a připravené k použití.

Požadované proměnné prostředí jsou specifické pro vaši instalaci a pro vámi zvolenou architekturu sestavení. Můžou se také změnit aktualizacemi nebo upgrady produktů. Tato variabilita je jedním z důvodů, proč doporučujeme místo nastavení proměnných prostředí použít nainstalovaný zástupce příkazového řádku nebo soubor příkazového řádku.

Sady nástrojů, soubory příkazů a klávesové zkratky nainstalované závisí na procesoru počítače a na možnostech, které jste vybrali během instalace. Nástroje hostované na platformě x86 a křížové nástroje, které sestavují kód x86 a x64, jsou vždy nainstalovány. Pokud máte 64bitovou Windows, nainstalují se také nástroje x64 hostované a křížové nástroje, které sestavují kód x86 a x64. Pokud zvolíte volitelné nástroje Univerzální platforma Windows C++, nainstalují se také nástroje x86 a x64, které sestavují kód ARM a ARM64. Jiné úlohy mohou tyto a další nástroje nainstalovat.

Proměnné cesty a prostředí pro sestavení příkazového řádku

Nástroje příkazového řádku MSVC používají proměnné prostředí PATH, TMP, INCLUDE, LIB a LIBPATH, a také používají další proměnné prostředí specifické pro nainstalované nástroje, platformy a sady SDK. Dokonce i jednoduchá instalace Visual Studio může nastavit dvacet nebo více proměnných prostředí. Tato složitost je důvod, proč důrazně doporučujeme použít zástupce pro příkazový řádek pro vývojáře nebo některý z přizpůsobených souborů příkazů. Tyto proměnné nedoporučujeme v prostředí Windows nastavit sami.

Pokud chcete zjistit, které proměnné prostředí jsou nastavené zástupcem příkazového řádku vývojáře, použijte SET tento příkaz. Otevřete jednoduché okno příkazového řádku a zachyťte výstup příkazu SET pro základní linii. Otevřete okno příkazového řádku vývojáře a zobrazte výstup SET příkazu pro porovnání. Pomocí nástroje rozdílu, jako je například nástroj integrovaný do Visual Studio, zvýrazněte proměnné prostředí nastavené příkazovým řádkem vývojáře. Další informace o proměnných prostředí kompilátoru a linkeru najdete v tématu Proměnné prostředí CL.

Klávesové zkratky příkazového řádku pro vývojáře

Klávesové zkratky příkazového řádku se instalují do složky specifické pro verzi Visual Studio v nabídce Windows Start. Tady je seznam zástupců základního příkazového řádku a architektur sestavení, které podporují:

• Developer Command Prompt – Nastaví prostředí tak, aby používalo 32bitové nástroje x86 nativní pro sestavení 32bitového nativního kódu x86.
• x86 Native Tools Command Prompt – Nastaví prostředí k používání 32bitových x86-nativních nástrojů k sestavení 32bitového x86-nativního kódu.
• x64 Native Tools Command Prompt – Nastaví prostředí tak, aby používalo 64bitové nástroje nativní pro x64 pro sestavení 64bitového nativního kódu x64.
• Příkazový řádek pro nástroje x86_x64 – Nastaví prostředí tak, aby používalo 32bitové nástroje pro nativní x86 k sestavení 64bitového kódu pro nativní x64.
• Příkazový řádek pro křížové nástroje x64_x86 – Nastaví prostředí tak, aby používalo 64bitové nástroje x64 k sestavení 32bitového kódu nativního pro x86.

Složka nabídky Start a názvy zástupců se liší v závislosti na nainstalované verzi Visual Studio. Pokud ho nastavíte, budou také záviset na instalaci Přezdívka. Předpokládejme například, že jste nainstalovali Visual Studio 2022 a dali jste mu přezdívku Latest. Zástupce příkazového řádku vývojáře má název Developer Command Prompt for VS 2022 (Latest) ve složce s názvem Visual Studio 2022.

Poznámka:

Několik nástrojů příkazového řádku nebo možností nástrojů může vyžadovat oprávnění správce. Pokud máte problémy s oprávněními při jejich používání, doporučujeme otevřít okno příkazového řádku vývojáře pomocí možnosti Spustit jako správce . Klikněte pravým tlačítkem myši pro otevření kontextového menu pro okno příkazového řádku a vyberte Více, Spustit jako správce.

Otevření okna příkazového řádku pro vývojáře

1. Na ploše otevřete nabídku Windows Start. V Windows 11 zvolte tlačítko Všechny aplikace a otevřete seznam nainstalovaných aplikací. V Windows 10 je seznam otevřený vlevo. Posuňte se v seznamu dolů a vyhledejte a otevřete složku (ne aplikaci) pro vaši verzi Visual Studio, například Visual Studio 2022.

2. Ve složce zvolte příkazový řádek Developer pro vaši verzi Visual Studio. Tento zástupce otevře příkazový řádek pro vývojáře, který využívá výchozí 32bitovou architekturu sestavení s nástroji x86-nativními, pro sestavení 32bitového x86-nativního kódu. Pokud dáváte přednost jiné než výchozí architektuře sestavení, zvolte jeden z nativních nebo křížových příkazů příkazového řádku pro určení architektury hostitele a cíle.

Pokud chcete ještě rychlejší způsob, jak otevřít příkazový řádek pro vývojáře, zadejte do vyhledávacího pole plochy příkazový řádek pro vývojáře. Pak zvolte požadovaný výsledek.

Poznámka:

Ve výchozím nastavení je aktuální pracovní adresář na příkazovém řádku vývojáře kořenem vaší Visual Studio instalace v adresáři Program Files. Toto není vhodné umístění pro váš kód a projekty. Před vytvořením projektu změňte aktuální pracovní adresář na jiné místo. Integrované vývojové prostředí (IDE) vytváří projekty ve vašem uživatelském adresáři, obvykle v %USERPROFILE%\source\repos.

Umístění souborů vývojářských příkazů

Pokud dáváte přednost nastavení prostředí sestavení v existujícím okně příkazového řádku, můžete použít jeden z souborů příkazů vytvořených instalačním programem. Doporučujeme nastavit prostředí v novém okně příkazového řádku. Ve stejném příkazovém okně nedoporučujeme později přepínat prostředí.

Umístění souboru příkazu závisí na verzi Visual Studio, kterou jste nainstalovali, a na možnostech, které jste provedli během instalace. Pro Visual Studio 2022 je typické umístění instalace v 64bitovém systému v \Program Files\Microsoft Visual Studio\2022\<edition>. Může <edition> to být Community, Professional, Enterprise, BuildTools nebo jiná přezdívka, kterou jste zadali.

Primární příkazový soubor vývojářského příkazového řádku, VsDevCmd.bat, se nachází v podadresáři Common7\Tools. Pokud nejsou zadány žádné parametry, nastaví prostředí tak, aby k sestavení 32bitového kódu pro x86 používaly nástroje nativní pro x86.

K dispozici jsou další soubory příkazů pro nastavení konkrétních architektur sestavení. Dostupné soubory příkazů závisí na Visual Studio úlohách a možnostech, které jste nainstalovali. V Visual Studio 2017 a Visual Studio 2019 je najdete v podadresáři VC\Auxiliary\Build.

Tyto soubory příkazů nastaví výchozí parametry a spustí VsDevCmd.bat k nastavení prostředí pro zadanou architekturu sestavení. Typická instalace může obsahovat tyto soubory příkazů:

Příkazový soubor	Architektury hostitelů a cílů
vcvars32.bat	Pomocí 32bitových nástrojů x86 nativních pro sestavení 32bitového kódu x86.
vcvars64.bat	Pomocí nativních 64bitových nástrojů x64 sestavte 64bitový kód x64.
vcvarsx86_amd64.bat	K sestavení 64bitového kódu x64 použijte 32bitové křížové nástroje nativní pro x86.
vcvarsamd64_x86.bat	K sestavení 32bitového kódu x86 použijte 64bitové křížové nástroje nativní pro x64.
vcvarsx86_arm.bat	K sestavení kódu ARM použijte 32bitové křížové nástroje nativní pro x86.
vcvarsamd64_arm.bat	K vytvoření kódu ARM použijte 64bitové křížové nástroje nativní pro x64.
vcvarsx86_arm64.bat	K sestavení kódu ARM64 použijte 32bitové křížové nástroje nativní pro x86.
vcvarsamd64_arm64.bat	K vytvoření kódu ARM64 použijte 64bitové křížové nástroje nativní pro x64.
vcvarsall.bat	Pomocí parametrů můžete určit architekturu hostitele a cíle, Windows SDK a volby platformy. Pro seznam podporovaných možností volejte pomocí parametru /help .

Upozornění

Soubor vcvarsall.bat a další soubory příkazů Visual Studio se můžou lišit od počítače po počítač. Nenahrazovat chybějící nebo poškozený vcvarsall.bat soubor pomocí souboru z jiného počítače. Znovu spusťte instalační program Visual Studio a nahraďte chybějící soubor.

Soubor vcvarsall.bat se také liší od verze po verzi. Pokud je aktuální verze Visual Studio nainstalovaná v počítači, který má také starší verzi Visual Studio, nespouštět vcvarsall.bat nebo jiný soubor příkazů Visual Studio z různých verzí ve stejném okně příkazového řádku.

Použití vývojářských nástrojů v existujícím příkazovém okně

Nejjednodušší způsob, jak určit konkrétní architekturu sestavení v existujícím příkazovém okně, je použít vcvarsall.bat soubor. Slouží vcvarsall.bat k nastavení proměnných prostředí ke konfiguraci příkazového řádku pro nativní 32bitovou nebo 64bitovou kompilaci. Argumenty umožňují zadat křížovou kompilaci na procesory x86, x64, ARM nebo ARM64. Můžete cílit na platformy Microsoft Store, Univerzální platforma Windows nebo Windows Desktop. Můžete dokonce určit, kterou sadu Windows SDK použít, a vybrat verzi sady nástrojů platformy.

Při použití bez argumentů vcvarsall.bat nakonfiguruje proměnné prostředí tak, aby používaly aktuální kompilátor nativní pro x86 pro 32bitové cíle prostředí Windows Desktop. Můžete přidat argumenty pro konfiguraci prostředí tak, aby používalo libovolný z nativních nebo křížových nástrojů kompilátoru. vcvarsall.bat zobrazí chybovou zprávu, pokud zadáte konfiguraci, která není nainstalovaná nebo není v počítači dostupná.

Syntaxe vcvarsall

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

architecture
Tento volitelný argument určuje architekturu hostitele a cíle, která se má použít. Pokud architecture není zadané, použije se výchozí prostředí sestavení. Podporují se tyto argumenty:

architecture	kompilátor	Architektura hostitelského počítače	Architektura výstupu sestavení (cíl)
x86	x86 – nativní 32bitová verze	x86, x64	x86
x86_amd64 nebo x86_x64	x64 na x86 křížová kompilace	x86, x64	x64
x86_arm	ARM na křížku x86	x86, x64	ARM
x86_arm64	ARM64 na křížku x86	x86, x64	ARM64
amd64 nebo x64	x64 – nativní 64bitová verze	x64	x64
amd64_x86 nebo x64_x86	x86 na x64 křížová compatibilita	x64	x86
amd64_arm nebo x64_arm	ARM na křížku x64	x64	ARM
amd64_arm64 nebo x64_arm64	ARM64 na křížku x64	x64	ARM64

platform_type
Tento volitelný argument umožňuje zadat store nebo uwp jako typ platformy. Ve výchozím nastavení je prostředí nastavené na vytváření desktopových nebo konzolových aplikací.

winsdk_version
Volitelně určuje verzi sady Windows SDK, která se má použít. Ve výchozím nastavení se používá nejnovější nainstalovaná sada WINDOWS SDK. Pokud chcete zadat verzi sady WINDOWS SDK, můžete použít celé číslo sady SDK Windows, například 10.0.10240.0, nebo zadat 8.1 pro použití sady Windows 8.1 SDK.

vcversion
Volitelně určuje sadu nástrojů kompilátoru Visual Studio, která se má použít. Ve výchozím nastavení je prostředí nastavené tak, aby používalo aktuální sadu nástrojů kompilátoru Visual Studio.

Pomocí -vcvars_ver=14.2x.yyy zadejte konkrétní verzi sady nástrojů kompilátoru Visual Studio 2019.

Pomocí -vcvars_ver=14.29 zadejte nejnovější verzi sady nástrojů kompilátoru Visual Studio 2019.

Pomocí -vcvars_ver=14.0 zadejte sadu nástrojů kompilátoru Visual Studio 2015.

spectre_mode
Pokud chcete používat knihovny bez omezení rizik Spectre, ponechte tento parametr mimo. Použijte hodnotu spectre pro použití knihoven se zmírněním rizik Spectre.

Nastavení prostředí sestavení v existujícím okně příkazového řádku

1. Na příkazovém řádku pomocí příkazu CD přejděte do instalačního adresáře Visual Studio. Potom znovu použijte CD k přechodu do podadresáře, který obsahuje konfiguračně specifické příkazové soubory. Pro Visual Studio 2019 a Visual Studio 2017 použijte podadresář VC\Auxiliary\Build. Pro Visual Studio 2015 použijte podadresář VC.

2. Zadejte příkaz pro upřednostňované vývojové prostředí. Pokud chcete například sestavit kód ARM pro UPW na 64bitové platformě pomocí nejnovější sady nástrojů sady Windows SDK a Visual Studio kompilátoru, použijte tento příkazový řádek:

   vcvarsall.bat amd64_arm uwp
   

Vytvořte si svého zástupce příkazového řádku

Otevřete dialogové okno Vlastnosti pro zástupce příkazového řádku vývojáře a zobrazte použitý cíl příkazu. Například cíl příkazového řádku nativních nástrojů x64 pro zástupce VS 2019 je podobný následujícímu:

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

Dávkové soubory specifické pro architekturu nastaví parametr architecture a spustí vcvarsall.bat. Stejné možnosti můžete předat dávkovým souborům, jako byste předali vcvarsall.bat, nebo můžete jednoduše použít vcvarsall.bat přímo. Pokud chcete zadat parametry pro vlastní zástupce příkazu, přidejte je na konec příkazu v dvojitých uvozovkách. Tady je například zástupce pro kompilaci kódu pro ARM pro UWP na 64bitové platformě pomocí nejnovější sady Windows SDK. Pokud chcete použít starší sadu nástrojů kompilátoru, zadejte číslo verze. V klávesové zkratce použijte něco podobného jako tento cíl příkazu:

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

Upravte cestu tak, aby odrážela instalační adresář Visual Studio. Soubor vcvarsall.bat obsahuje další informace o konkrétních číslech verzí.

Nástroje příkazového řádku

Pokud chcete vytvořit projekt C/C++ na příkazovém řádku, Visual Studio poskytuje tyto nástroje příkazového řádku:

CL
Pomocí kompilátoru (cl.exe) zkompilujte a propojte soubory zdrojového kódu do aplikací, knihoven a knihoven DLL.

Link
Pomocí linkeru (link.exe) můžete propojit kompilované soubory a knihovny objektů do aplikací a knihoven DLL.

Při sestavování na příkazovém řádku není příkaz F1 k dispozici pro okamžitou pomoc. Místo toho můžete pomocí vyhledávacího webu získat informace o upozorněních, chybách a zprávách. Můžete si také stáhnout a použít offline soubory nápovědy. Pokud chcete hledání použít v Microsoft Learn, zadejte svůj dotaz do vyhledávacího pole v horní části libovolného článku.

Nástroje příkazového řádku pro řízení projektů

Ve výchozím nastavení Visual Studio – sada IDE používá nativní systémy sestavení projektů založené na nástroji MSBuild. MsBuild můžete vyvolat přímo pro sestavení projektů bez použití integrovaného vývojového prostředí (IDE). K vytváření projektů a řešení můžete použít také Visual Studio příkaz devenv. Visual Studio také podporuje systémy sestavení založené na CMake nebo NMake.

MSBuild
Ke konfiguraci sestavení a vyvolání sady nástrojů bez načtení Visual Studio – sada IDE použijte msBuild (msbuild.exe) a soubor projektu (.vcxproj). Je ekvivalentem spuštění projektu Build nebo příkazu Build Solution v Visual Studio – sada IDE. Nástroj MSBuild má výhody oproti integrovanému vývojovému prostředí při sestavování na příkazovém řádku. Nemusíte instalovat úplné integrované vývojové prostředí (IDE) na všechny vaše buildové servery a kanály sestavení. Vyhnete se dodatečným režijním nákladům integrovaného vývojového prostředí (IDE). MSBuild běží v kontejnerizovaných prostředích a podporuje binární logger.

DEVENV
Pomocí příkazu DEVENV (devenv.exe) v kombinaci s přepínačem příkazového řádku, jako je /Build nebo /Clean, spusťte určité příkazy sestavení bez zobrazení Visual Studio – sada IDE.

CMake
CMake (cmake.exe) je multiplatformní opensourcový nástroj pro definování procesů sestavení, které běží na více platformách. CMake může konfigurovat a řídit nativní nástroje sestavení pro podporované platformy, jako je MSBuild a Make. Další informace o CMake najdete v dokumentaci k CMake.

NMAKE
Pomocí nástroje NMAKE (nmake.exe) sestavte projekty C++ pomocí tradičního souboru pravidel.

Poznámka:

Počínaje Visual Studio 2019 verze 16.5 nástroj MSBuild a DEVENV nepoužívají prostředí příkazového řádku k řízení používané sady nástrojů a knihoven.

V této části

V těchto článcích se dozvíte, jak vytvářet aplikace na příkazovém řádku a jak přizpůsobit prostředí sestavení příkazového řádku. Některé ukazují, jak používat 64bitové sady nástrojů a cílové platformy x86, x64, ARM a ARM64. Popisují také použití nástrojů pro sestavení příkazového řádku MSBuild a NMAKE.

Návod: Kompilace nativního programu C++ na příkazovém řádku
Poskytuje příklad, který ukazuje, jak vytvořit a zkompilovat program C++ na příkazovém řádku.

Návod: Kompilace programu C v příkazovém řádku
Popisuje, jak zkompilovat program napsaný v programovacím jazyce C.

Návod: Kompilace programu C++/CLI na příkazovém řádku
Popisuje, jak vytvořit a zkompilovat program C++/CLI, který používá .NET Framework.

Návod: Kompilace programu C++/CX na příkazovém řádku
Popisuje, jak vytvořit a zkompilovat program C++/CX, který používá prostředí Windows Runtime.

Referenční informace k NMAKE
Obsahuje odkazy na články, které popisují nástroj Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild na příkazovém řádku - C++
Obsahuje odkazy na články, které popisují použití msbuild.exe z příkazového řádku.

Související oddíly

/MD, , /MT/LD (použití knihovny runtime)
Popisuje, jak pomocí těchto možností kompilátoru použít běhovou knihovnu pro ladění nebo provozní verzi.

Možnosti kompilátoru C/C++
Obsahuje odkazy na články, které popisují možnosti kompilátoru C a C++ a CL.exe.

Možnosti linkeru MSVC
Poskytuje odkazy na články, které popisují možnosti linkeru a LINK.exe.

Další nástroje sestavení MSVC
Poskytuje odkazy na nástroje sestavení C/C++, které jsou součástí Visual Studio.

Viz také

Projekty a systémy sestavení