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) si můžete stáhnout také jako samostatný balíček. Pokud ho nechcete používat, nemusíte instalovat Visual Studio – sada IDE.

Stažení a instalace nástrojů

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

Když v instalačním programu Visual Studio zvolíte některou z úloh C++, nainstaluje ve výchozím nastavení konkrétní verzi balíčku MSVC Build Tools. Pro Visual Studio 2022 a starší je balíček uspořádaný pomocí sady nástrojů platform toolset (formát verze v###), která obsahuje všechny nástroje jazyka C a C++ pro konkrétní verzi Visual Studio. Od Visual Studio 2026 je verze MSVC oddělená od verze Visual Studio. Jinými slovy, od Visual Studio 2026 dále balíček odpovídá verzi sady nástrojů MSVC (v##.### version format), která obsahuje všechny nástroje C a C++ pro tento konkrétní balíček MSVC Build Tools.

Mezi nástroje patří kompilátory C/C++, linkery, assemblery a další nástroje sestavení. Obsahuje 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 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.

Nástroje vyžadují nastavení několika proměnných prostředí. Tyto proměnné přidávají nástroje do cesty a nastavují 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, Windows verzi sady SDK a sadu nástrojů platformy.

Pro usnadnění používání instalačního programu také vytvoří zástupce v nabídce Start . Klávesové zkratky otevírají okna příkazového řádku pro vývojáře pomocí těchto souborů příkazů pro konkrétní kombinace hostitelských a cílových architektur. 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í. Aktualizace nebo upgrady produktů můžou měnit proměnné. 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, které instalační program přidá, závisí na procesoru počítače a na možnostech, které vyberete 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. Tyto nástroje mohou instalovat i jiné úlohy.

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. Používají také 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.

Chcete-li zjistit, které proměnné prostředí nastavuje zástupce příkazového řádku pro vývojáře, použijte příkaz SET. Otevřete běžné okno příkazového řádku a jako výchozí referenci zaznamenejte výstup příkazu SET. 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 nainstalují do složky Visual Studio specifické pro verzi ve vaší 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 k sestavení 32bitového kódu x86.
• x86 Native Tools Command Prompt. Nastaví prostředí tak, aby používalo 32bitové nástroje x86 k sestavení 32bitového kódu x86.
• x64 Native Tools Command Prompt. Nastaví prostředí tak, aby používalo 64bitové nástroje x64 k sestavení 64bitového kódu x64.
• Příkazový řádek křížových nástrojů x86_x64. Nastaví prostředí tak, aby používalo 32bitové nástroje x86 k sestavení 64bitového kódu x64.
• Příkazový řádek nástrojů pro křížovou kompilaci x64_x86. Nastaví prostředí tak, aby používalo 64bitové nástroje x64 k sestavení 32bitového kódu x86.

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

1. Na ploše otevřete nabídku Windows Start. V Windows 11 zvolte 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 nebo Visual Studio pro verzi 2026 a novější.
2. Ve složce zvolte příkazový řádek Developer pro vaši verzi Visual Studio. Tento zástupce spustí okno příkazového řádku pro vývojáře, které nastaví prostředí tak, aby používalo 32bitové nástroje x86 k sestavení 32bitového kódu x86. Pokud dáváte přednost jiné než výchozí architektuře sestavení, zvolte jeden z příkazových řádků pro nativní nástroje nebo nástroje pro křížové sestavení a zadejte hostitelskou a cílovou architekturu.

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.

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í.

Hlavní příkazový soubor pro příkazový řádek pro vývojáře, VsDevCmd.bat, se nachází v adresáři Common7\Tools. Pokud nezadáte parametry, nastaví prostředí tak, aby k sestavení 32bitového kódu x86 používaly nástroje nativní pro x86.

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ů:

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í pro konfiguraci okna 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.

Pokud použijete vcvarsall.bat bez argumentů, nakonfiguruje proměnné prostředí tak, aby používaly aktuální kompilátor x86 nativní pro 32bitové cíle Windows Desktopu. Přidejte argumenty pro konfiguraci prostředí tak, aby používalo některý 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 nezadáte architecture, použije se výchozí prostředí sestavení. Podporují se následující 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 určuje 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, použijte úplné číslo sady SDK Windows, například 10.0.10240.0, nebo zadejte 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í prostředí používá nejnovější nainstalovanou sadu nástrojů kompilátoru Visual Studio. Následující tabulka ukazuje ukázkové vcvars_ver hodnoty:

  vcvars_ver={value}	Result	Příklad VS 2026	Příklad VS 2022	Příklad VS 2019	Příklad VS 2017
  "Preview"	Použijte sadu nástrojů kompilátoru Visual Studio Preview.	Supported	Nepodporováno	Nepodporováno	Nepodporováno
  "14.0"	Použijte sadu nástrojů kompilátoru Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Použijte nejnovější nainstalovanou 14.xx.yyyyy sadu nástrojů.	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Použijte konkrétní celé číslo verze.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Pokud chcete používat knihovny bez omezení rizik Spectre, ponechte tento parametr mimo. Zadejte spectre, chcete-li používat knihovny s ochranou proti zranitelnosti 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. Pokud například používáte Visual studio 2026, C:\Program Files\Microsoft Visual Studio\18\Professional. Potom znovu použijte CD k přechodu do podadresáře, který obsahuje konfiguračně specifické příkazové soubory. Pro Visual Studio 2017 a novější 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 například chcete vytvořit kód ARM pro UPW na 64bitové platformě, použijte nejnovější sadu nástrojů sady Windows SDK a Visual Studio kompilátoru:

   vcvarsall.bat amd64_arm uwp
   

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

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvars64.bat"

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"

Dávkové soubory specifické pro architekturu nastaví parametr architecture a spustí vcvarsall.bat. Těmto dávkovým souborům můžete předat stejné možnosti jako příkazu vcvarsall.bat, nebo můžete přímo zavolat vcvarsall.bat. Chcete-li pro vlastní zkratku příkazu zadat parametry, přidejte je na konec příkazu do dvojitých uvozovek. Pokud chcete použít starší sadu nástrojů kompilátoru, zadejte číslo verze.

Od Visual Studio 2026 můžete cílit jenom na ARM64, protože cílení ARM32 bylo odebráno.

Tady je zkratka pro sestavení kódu ARM64 pro UWP na 64bitové platformě pomocí nejnovější sady Windows SDK. Možnost cílení na ARM64 se zobrazuje pro Visual Studio 2026 a novějších verzí. Cílení na ARM32 se zobrazuje u starších verzí.

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm64 uwp -vcvars_ver=14.50

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

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0

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.

Viz také

• Návod: Kompilace nativního programu C++ na příkazovém řádku
• Návod: Kompilace programu C v příkazovém řádku
• Návod: Kompilace programu C++/CLI na příkazovém řádku
• Návod: Kompilace programu C++/CX na příkazovém řádku
• Projekty a systémy sestavení
• /MD, , /MT/LD (použití knihovny runtime)
• Možnosti kompilátoru C/C++
• Možnosti linkeru MSVC
• Další nástroje sestavení MSVC