Použití sady nástrojů 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í sady Visual Studio. Sada nástrojů kompilátoru Microsoft C++ (MSVC) je také ke stažení jako samostatný balíček. Pokud ho nechcete používat, nemusíte instalovat integrované vývojové prostředí sady Visual Studio.

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 sadě 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 Sadu Visual Studio a úlohu C++, máte všechny nástroje příkazového řádku. Informace o tom, jak nainstalovat C++ a Visual Studio, naleznete v tématu Instalace podpory jazyka C++ v sadě Visual Studio. Pokud chcete jenom sadu nástrojů příkazového řádku, stáhněte si Nástroje sestavení pro Visual Studio. Když spustíte stažený spustitelný soubor, aktualizuje se a spustí Instalační program pro 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ů sady 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ž v Instalační program pro Visual Studio zvolíte některou z úloh C++, nainstaluje sadu nástrojů platformy Visual Studio. Sada nástrojů platformy obsahuje všechny nástroje jazyka C a C++ pro konkrétní verzi sady 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. Také je interně používá integrované vývojové prostředí sady Visual Studio. Existují samostatné kompilátory a nástroje hostované na platformě x86 a x64 pro sestavování kódu pro cíle x86, x64, ARM a ARM64. Každá sada nástrojů pro konkrétní architekturu sestavení hostitele a cíle je uložená ve 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 cesty a k nastavení umístění souborů, souborů knihovny 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, verzi sady Windows SDK a sadu nástrojů platformy. Pro usnadnění práci instalační program také vytvoří zástupce ve vašem nabídka 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 verzi 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 C++ Univerzální platforma Windows, nainstalují se také nástroje x86 a x64, které sestavují kód ARM a ARM64. Jiné úlohy můžou 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é příkazového PATHřádku , , TMPINCLUDE, LIBa LIBPATH prostředí a také používají další proměnné prostředí specifické pro nainstalované nástroje, platformy a sady SDK. I jednoduchá instalace sady 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 příkazového řádku pro vývojáře nebo některý z přizpůsobených souborů příkazů. Nedoporučujeme, abyste tyto proměnné nastavili sami v prostředí Windows.

Pokud chcete zjistit, které proměnné prostředí jsou nastavené zástupcem příkazového řádku vývojáře, můžete použít SET tento příkaz. Otevřete okno příkazového řádku a zachyťte výstup SET příkazu pro směrný plán. 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 sady 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 jsou nainstalované ve složce sady Visual Studio specifické pro verzi ve vašem nabídka Start Windows. 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í tak, aby používalo 32bitové nástroje x86 nativní nástroje k sestavení 32bitového nativního kódu x86.
• 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.
• x86_x64 příkazového řádku křížových nástrojů – Nastaví prostředí tak, aby používalo 32bitové nástroje nativní pro x86 k sestavení 64bitového nativního kódu x64.
• x64_x86 příkazového řádku křížových nástrojů – Nastaví prostředí tak, aby používalo 64bitové nástroje nativní pro x64 k sestavení 32bitového nativního kódu x86.

Názvy nabídka Start složek a zástupců se liší v závislosti na nainstalované verzi sady 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 Nejnovější. Zástupce příkazového řádku pro vývojáře má název Developer Command Prompt pro VS 2022 (nejnovější) 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 Správa istrator oprávnění. Pokud máte při jejich používání problémy s oprávněními, doporučujeme otevřít okno příkazového řádku pro vývojáře pomocí možnosti Spustit jako Správa istrator. Kliknutím pravým tlačítkem otevřete místní nabídku pro okno příkazového řádku a pak zvolte Další, Spustit jako správce.

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

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

2. Ve složce zvolte vývojářský příkazový řádek pro vaši verzi sady Visual Studio. Tento zástupce spustí okno příkazového řádku pro vývojáře, které používá výchozí architekturu sestavení 32bitových nástrojů x86 nativních k sestavení 32bitového kódu 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ář v příkazovém řádku vývojáře kořenem instalace sady Visual Studio 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 adresáři %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 sady Visual Studio, kterou jste nainstalovali, a na možnostech, které jste provedli během instalace. Pro Visual Studio 2019 je \Program Files\Microsoft Visual Studio\2022\<edition>typické umístění instalace v 64bitovém systému . Může <edition> to být Community, Professional, Enterprise, BuildTools nebo jiná přezdívka, kterou jste zadali.

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

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

Tyto soubory příkazů nastaví výchozí parametry a volání VsDevCmd.bat pro nastavení zadaného prostředí architektury 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í 64bitových nástrojů x64 nativních pro sestavení 64bitového kódu 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	Parametry slouží k určení hostitelských a cílových architektur, sady Windows SDK a možností platformy. Pro seznam podporovaných možností volejte pomocí parametru /help .

Upozornění

Soubor vcvarsall.bat a další soubory příkazů sady 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 sady Visual Studio a nahraďte chybějící soubor.

Soubor vcvarsall.bat se také liší od verze po verzi. Pokud je aktuální verze sady Visual Studio nainstalovaná na počítači, který má také starší verzi sady Visual Studio, nespouštět vcvarsall.bat ani jiný příkazový soubor sady 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 chcete použít, a vybrat verzi sady nástrojů platformy.

Při použití bez argumentů nakonfiguruje proměnné prostředí tak, vcvarsall.bat aby používaly aktuální kompilátor nativní pro x86 pro 32bitové cíle plochy Windows. 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 není zadaná architektura , použije se výchozí prostředí sestavení. Podporují se tyto argumenty:

architecture	Compiler	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 křížku x86	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 křížku x64	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. Chcete-li zadat verzi sady Windows SDK, můžete použít úplné číslo sady Windows SDK, například 10.0.10240.0nebo zadat 8.1 , aby bylo možné použít sadu SDK systému Windows 8.1.

vcversion
Volitelně určuje sadu nástrojů kompilátoru sady 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 sady Visual Studio.

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

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

Pomocí parametru -vcvars_ver=14.0 zadejte sadu nástrojů kompilátoru sady 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 sady Visual Studio. Potom pomocí příkazu CD znovu přejděte do podadresáře, který obsahuje soubory příkazů specifické pro konfiguraci. 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 sady nástrojů kompilátoru sady Visual Studio, použijte tento příkazový řádek:

   vcvarsall.bat amd64_arm uwp

Vytvoření vlastní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 architecture nastaví parametr a volání vcvarsall.bat. Stejné možnosti můžete předat těmto dávkovým souborům, jako byste předali vcvarsall.bat, nebo můžete volat 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 sestavení kódu ARM pro UPW 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 odpovídala instalačnímu adresáři sady Visual Studio. Soubor vcvarsall.bat obsahuje další informace o konkrétních číslech verzí.

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

K sestavení projektu C/C++ na příkazovém řádku poskytuje Visual Studio 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 objektů a knihovny 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 použít vyhledávání v Microsoft Learn, zadejte svůj dotaz do vyhledávacího pole v horní části libovolného článku.

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

Integrované vývojové prostředí sady Visual Studio ve výchozím nastavení 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). Příkaz můžete použít devenv také k vytváření projektů a řešení pomocí sady Visual Studio. Visual Studio také podporuje systémy sestavení založené na CMake nebo NMake.

MSBuild
Pomocí nástroje MSBuild (msbuild.exe) a souboru projektu (.vcxproj) nakonfigurujte sestavení a vyvoláte sadu nástrojů bez načtení integrovaného vývojového prostředí sady Visual Studio. Je to ekvivalent spuštění projektu sestavení nebo příkazu Sestavit řešení v integrovaném vývojovém prostředí sady Visual Studio. 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). NÁSTROJ MSBuild běží v kontejnerizovaných prostředích sestavení a podporuje binární protokolovací nástroj.

DEVENV
DeVENV (devenv.exe) v kombinaci s přepínačem příkazového řádku, například /Build nebo /Clean ke spuštění určitých příkazů sestavení bez zobrazení integrovaného vývojového prostředí sady Visual Studio.

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 sadou 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á rozhraní .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).

NÁSTROJ MSBuild na příkazovém řádku – C++
Poskytuje 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 knihovnu run-time ladění nebo vydané verze.

Možnosti kompilátoru C/C++
Poskytuje 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é diskutují o možnostech linkeru a LINK.exe.

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

Viz také

Projekty a systémy sestavení