Korzystanie z narzędzi Microsoft C++ Build Tools z wiersza polecenia

Aplikacje języka C i C++ można tworzyć w wierszu polecenia przy użyciu narzędzi zawartych w Visual Studio. Możesz również pobrać narzędzia kompilacji Microsoft C++ (MSVC) jako pakiet autonomiczny. Nie musisz instalować Visual Studio IDE, jeśli nie planujesz go używać.

Uwaga

W tym artykule opisano sposób konfigurowania środowiska do używania poszczególnych kompilatorów, konsolidatorów, bibliotek i innych podstawowych narzędzi. Natywny system kompilacji projektu w Visual Studio oparty na programie MSBuild nie używa środowiska zgodnie z opisem w tym artykule. Aby uzyskać więcej informacji na temat używania programu MSBuild z poziomu wiersza polecenia, zobacz MSBuild w wierszu polecenia — C++.

Pobieranie i instalowanie narzędzi

Jeśli zainstalowałeś(-aś) program Visual Studio i pakiet roboczy języka C++, masz wszystkie narzędzia wiersza polecenia. Aby uzyskać informacje na temat sposobu instalowania języka C++ i Visual Studio, zobacz Zainstaluj obsługę języka C++ w Visual Studio.

Jeśli chcesz tylko zestaw narzędzi wiersza polecenia, pobierz zestaw narzędzi Build Tools for Visual Studio. Na stronie pobierania plików rozwiń sekcję Tools for Visual Studio, aby znaleźć plik do pobrania narzędzi Build Tools. Po uruchomieniu pobranego pliku wykonywalnego program aktualizuje i uruchamia instalator Visual Studio.

Aby zainstalować tylko narzędzia potrzebne do programowania C++, wybierz pakiet roboczy Programowanie aplikacji desktopowych w C++. W obszarze Szczegóły instalacji możesz wybrać opcjonalne biblioteki i zestawy narzędzi. Aby skompilować kod przy użyciu zestawów narzędzi Visual Studio 2015, Visual Studio 2017 lub Visual Studio 2019, wybierz opcjonalne narzędzia kompilacji MSVC w wersji 140, v141 lub v142. Jeśli wybrane opcje są zadowalające, wybierz pozycję Zainstaluj.

Jak używać narzędzi wiersza polecenia

Po wybraniu jednego z obciążeń języka C++ w instalatorze Visual Studio program instaluje domyślnie określoną wersję pakietu narzędzi MSVC Build Tools. W przypadku Visual Studio 2022 i starszych pakiet jest zorganizowany przez zestaw narzędzi platform (format wersji v####), który zawiera wszystkie narzędzia języka C i C++ dla określonej wersji Visual Studio. Począwszy od Visual Studio 2026 r., wersja MSVC jest oddzielona od wersji Visual Studio. Innymi słowy, od Visual Studio 2026 r. pakiet odpowiada wersji zestawu narzędzi MSVC (v##.###), który zawiera wszystkie narzędzia języka C i C++ dla danego pakietu narzędzi MSVC Build Tools.

Narzędzia obejmują kompilatory języka C/C++, konsolidatory, asemblery i inne narzędzia kompilacji. Zawiera pasujące biblioteki i pliki nagłówkowe. Wszystkie te narzędzia można używać w wierszu polecenia. Visual Studio IDE używa ich wewnętrznie. Istnieją oddzielne kompilatory i narzędzia hostowane w architekturze x86 i x64, które kompilują kod dla elementów docelowych x86, x64, ARM i ARM64. Każdy zestaw narzędzi dla określonego hosta i docelowej architektury kompilacji jest przechowywany we własnym katalogu.

Narzędzia wymagają ustawienia kilku zmiennych środowiskowych. Te zmienne dodają narzędzia do ścieżki i ustawiają lokalizacje plików dołączanych, plików biblioteki i zestawów SDK. Aby ułatwić ustawianie tych zmiennych środowiskowych, instalator tworzy niestandardowe pliki poleceń lub pliki wsadowe podczas instalacji. Możesz uruchomić jeden z tych plików poleceń, aby ustawić określony host i docelową architekturę kompilacji, Windows wersję zestawu SDK i zestaw narzędzi platformy.

Dla wygody instalator tworzy również skróty w menu Start . Skróty otwierają okna wiersza polecenia dla deweloperów przy użyciu tych plików poleceń dla określonych kombinacji architektur hostów i obiektów docelowych. Te skróty zapewniają, że wszystkie wymagane zmienne środowiskowe są ustawione i gotowe do użycia.

Wymagane zmienne środowiskowe są specyficzne dla instalacji i wybranej architektury kompilacji. Aktualizacje lub uaktualnienia produktów mogą zmieniać zmienne. Ta zmienność jest jedną z przyczyn, dla których zalecamy użycie zainstalowanego skrótu wiersza polecenia lub pliku polecenia zamiast ustawiania zmiennych środowiskowych samodzielnie.

Zestawy narzędzi, pliki poleceń i skróty, które dodaje instalator, zależą od procesora komputera i opcji wybranych podczas instalacji. Zawsze instalowane są narzędzia hostowane w architekturze x86 i narzędzia krzyżowe, które kompilują kod x86 i x64. Jeśli masz 64-bitowy Windows, instalowane są także narzędzia obsługujące x64 oraz narzędzia do kompilacji międzyplatformowej, które kompilują kod x86 i x64. Jeśli wybierzesz opcjonalne narzędzia platforma uniwersalna systemu Windows języka C++, instalowane są również narzędzia x86 i x64, które kompilują kod ARM i ARM64. Inne obciążenia robocze mogą instalować te narzędzia.

Ścieżki i zmienne środowiskowe dla kompilacji z wiersza poleceń

Narzędzia wiersza polecenia MSVC używają PATHzmiennych środowiskowych , TMP, INCLUDE, LIBi LIBPATH . Używają również innych zmiennych środowiskowych specyficznych dla zainstalowanych narzędzi, platform i zestawów SDK. Nawet prosta instalacja Visual Studio może ustawić dwadzieścia lub więcej zmiennych środowiskowych. Ten poziom złożoności jest powodem, dla którego zdecydowanie zalecamy użycie skrótu wiersza polecenia dewelopera lub jednego z dostosowanych plików poleceń. Nie zalecamy samodzielnego ustawiania tych zmiennych w środowisku Windows.

Aby zobaczyć, jakie zmienne środowiskowe ustawia skrót wiersza polecenia dewelopera, użyj polecenia SET. Otwórz zwykłe okno wiersza polecenia i przechwyć dane wyjściowe SET polecenia dla punktu odniesienia. Otwórz okno wiersza polecenia dla deweloperów i przechwyć dane wyjściowe SET polecenia w celu porównania. Użyj narzędzia do porównywania, takiego jak wbudowane w Visual Studio, aby wyróżnić zmienne środowiskowe ustawione przez wiersz polecenia programisty. Aby uzyskać więcej informacji na temat zmiennych środowiskowych kompilatora i konsolidatora, zobacz Zmienne środowiskowe CL.

Skróty wiersza polecenia dla deweloperów

Skróty wiersza polecenia są instalowane w folderze programu Visual Studio specyficznym dla danej wersji w menu Start systemu Windows. Oto lista podstawowych skrótów wiersza polecenia i architektur kompilacji, które obsługują:

• Deweloperski wiersz polecenia. Ustawia środowisko tak, aby używało 32-bitowych narzędzi x86 do kompilowania 32-bitowego kodu x86.
• x86 Native Tools — wiersz polecenia. Ustawia środowisko tak, aby używało 32-bitowych narzędzi x86 do kompilowania 32-bitowego kodu x86.
• x64 Native Tools — wiersz polecenia. Ustawia środowisko tak, aby używało 64-bitowych narzędzi x64 do kompilowania 64-bitowego kodu x64.
• x86_x64 Wiersz polecenia narzędzi międzyarchitekturowych. Ustawia środowisko tak, aby używało 32-bitowych narzędzi x86 do kompilowania 64-bitowego kodu x64.
• Wiersz polecenia narzędzi międzyplatformowych x64_x86. Ustawia środowisko tak, aby używało 64-bitowych narzędzi x64 do kompilowania 32-bitowego kodu x86.

Nazwy folderów w menu Start oraz skrótów różnią się w zależności od zainstalowanej wersji programu Visual Studio. Na przykład skrót wiersza polecenia dla deweloperów dla programu Visual Studio 2022 nosi nazwę Developer Command Prompt for VS 2022 w Start>Programs>Visual Studio 2022>Visual Studio Tools.

Uwaga

Kilka narzędzi wiersza polecenia lub opcji narzędzi wymaga uprawnień administratora. Jeśli masz problemy z uprawnieniami podczas ich używania, zalecamy otwarcie okna wiersza polecenia dewelopera przy użyciu opcji Uruchom jako administrator . Kliknij prawym przyciskiem myszy, aby otworzyć menu skrótów dla okna wiersza polecenia, a następnie wybierz pozycję Więcej>Uruchom jako administrator.

Aby otworzyć okno wiersza polecenia dla deweloperów

1. Na pulpicie otwórz menu Windows Start. W Windows 11 wybierz pozycję Wszystkie aplikacje aby otworzyć listę zainstalowanych aplikacji. W Windows 10 lista jest otwarta po lewej stronie. Przewiń listę w dół, aby znaleźć i otworzyć folder (a nie aplikację) dla używanej wersji Visual Studio, na przykład Visual Studio 2022 lub Visual Studio w wersji 2026 lub nowszej.
2. W folderze wybierz Developer Command Prompt odpowiednią dla twojej wersji Visual Studio. Ten skrót uruchamia okno wiersza polecenia dla deweloperów, które ustawia środowisko do użycia 32-bitowych narzędzi x86 do kompilowania 32-bitowego kodu x86. Jeśli wolisz architekturę kompilacji inną niż domyślna, wybierz jeden z wierszy polecenia narzędzi natywnych lub narzędzi do kompilacji krzyżowej, aby określić architekturę hosta i architekturę docelową.

Aby jeszcze szybciej otworzyć wiersz polecenia dla deweloperów, wprowadź wiersz polecenia dla deweloperów w polu wyszukiwania pulpitu. Następnie wybierz odpowiedni wynik.

Uwaga

Domyślnie bieżący katalog roboczy w wierszu polecenia dewelopera jest katalogiem głównym instalacji Visual Studio w katalogu Program Files. Ta lokalizacja nie jest odpowiednia dla kodu i projektów. Przed utworzeniem projektu zmień bieżący katalog roboczy na inną lokalizację. Środowisko IDE tworzy projekty w katalogu użytkownika, zazwyczaj w pliku %USERPROFILE%\source\repos.

Lokalizacje plików poleceń dla deweloperów

Jeśli wolisz ustawić środowisko kompilacji w istniejącym oknie wiersza polecenia, możesz użyć jednego z plików poleceń utworzonych przez instalatora. Zalecamy ustawienie środowiska w nowym oknie wiersza polecenia. Nie zalecamy późniejszego przełączania środowisk w tym samym oknie polecenia.

Lokalizacja pliku polecenia zależy od zainstalowanej wersji Visual Studio oraz od wyborów dokonanych podczas instalacji. W przypadku Visual Studio 2022 typową lokalizacją instalacji jest C:\Program Files\Microsoft Visual Studio\2022\<edition>. <edition> może być Community, Professional, Enterprise, BuildTools.

Główny plik poleceń wiersza polecenia dewelopera, VsDevCmd.bat, znajduje się w katalogu Common7\Tools. Jeśli nie określisz parametrów, ustawia środowisko tak, aby używało natywnych narzędzi x86 do kompilowania 32-bitowego kodu x86.

Dostępnych jest więcej plików poleceń do konfigurowania określonych architektur kompilacji. Dostępne pliki poleceń zależą od zainstalowanych obciążeń Visual Studio i opcji. W Visual Studio 2017 i Visual Studio 2019 r. znajdziesz je w katalogu VC\Auxiliary\Build.

Te pliki poleceń ustawiają domyślne parametry i wywołują VsDevCmd.bat w celu skonfigurowania określonego środowiska architektury kompilacji. Typowa instalacja może obejmować następujące pliki poleceń:

Plik polecenia	Architektury hostów i obiektów docelowych
vcvars32.bat	Użyj 32-bitowych narzędzi natywnych dla architektury x86, aby utworzyć 32-bitowy kod x86.
vcvars64.bat	Użyj 64-bitowych narzędzi natywnych dla architektury x64, aby skompilować 64-bitowy kod x64.
vcvarsx86_amd64.bat	Użyj 32-bitowych narzędzi krzyżowych x86-natywnych do kompilowania 64-bitowego kodu x64.
vcvarsamd64_x86.bat	Użyj 64-bitowych narzędzi krzyżowych x64-natywnych do kompilowania 32-bitowego kodu x86.
vcvarsx86_arm.bat	Użyj 32-bitowych, natywnych dla x86 narzędzi do tworzenia kodu ARM.
vcvarsamd64_arm.bat	Użyj 64-bitowych narzędzi międzyplatformowych natywnych dla x64 do budowania kodu ARM.
vcvarsx86_arm64.bat	Użyj 32-bitowych narzędzi krzyżowych x86-natywnych do kompilowania kodu ARM64.
vcvarsamd64_arm64.bat	Użyj 64-bitowych narzędzi krzyżowych x64-natywnych do kompilowania kodu ARM64.
vcvarsall.bat	Użyj parametrów, aby określić architektury hostów i obiektów docelowych, zestaw SDK Windows i opcje platformy. Aby uzyskać listę obsługiwanych opcji, wywołaj metodę przy użyciu parametru /help .

Uwaga

Plik vcvarsall.bat i inne pliki poleceń Visual Studio mogą się różnić od komputera do komputera. Nie zamieniaj brakującego lub uszkodzonego vcvarsall.bat pliku przy użyciu pliku z innego komputera. Uruchom ponownie instalatora Visual Studio, aby zastąpić brakujący plik.

Plik vcvarsall.bat różni się również od wersji do wersji. Jeśli bieżąca wersja Visual Studio jest zainstalowana na komputerze, który ma również starszą wersję Visual Studio, nie uruchamiaj vcvarsall.bat lub innego pliku polecenia Visual Studio z różnych wersji w tym samym oknie wiersza polecenia.

Korzystanie z narzędzi deweloperskich w istniejącym oknie poleceń

Najprostszym sposobem określenia konkretnej architektury kompilacji w istniejącym oknie poleceń jest użycie vcvarsall.bat pliku. Służy vcvarsall.bat do ustawiania zmiennych środowiskowych w celu skonfigurowania okna wiersza polecenia na potrzeby natywnej kompilacji 32-bitowej lub 64-bitowej. Argumenty umożliwiają określenie krzyżowej kompilacji na procesory x86, x64, ARM lub ARM64. Można celować w platformy Microsoft Store, platforma uniwersalna systemu Windows lub Windows Desktop. Można nawet określić, którego zestawu sdk Windows użyć, i wybrać wersję zestawu narzędzi platformy.

Jeśli używasz vcvarsall.bat bez argumentów, konfiguruje zmienne środowiskowe do używania bieżącego kompilatora x86-natywnego dla 32-bitowych obiektów docelowych Windows Desktop. Dodaj argumenty, aby skonfigurować środowisko do używania dowolnego z narzędzi natywnych lub krzyżowych kompilatora. vcvarsall.bat Wyświetla komunikat o błędzie, jeśli określisz konfigurację, która nie jest zainstalowana lub nie jest dostępna na komputerze.

Składnia vcvarsall

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

• architecture

  Ten opcjonalny argument określa architekturę hosta i architekturę docelową, której chcesz użyć. Jeśli nie określisz architecture, zostanie użyte domyślne środowisko kompilacji. Obsługiwane są następujące argumenty:

  architecture	Kompilator	Architektura komputera hosta	Architektura docelowa wyniku kompilacji
  x86	Natywna wersja 32-bitowa x86	x86, x64	x86
  x86_amd64 lub x86_x64	x64 na x86 kompilacja krzyżowa	x86, x64	x64
  x86_arm	Arm na skrzyżowaniu x86	x86, x64	ARM
  x86_arm64	Arm64 na x86 kompilacja krzyżowa	x86, x64	ARM64
  amd64 lub x64	Natywna wersja 64-bitowa x64	x64	x64
  amd64_x86 lub x64_x86	x86 na x64 krzyżówka	x64	x86
  amd64_arm lub x64_arm	ARM na x64 (kompilacja krzyżowa)	x64	ARM
  amd64_arm64 lub x64_arm64	ARM64 na X64 (cross-kompilacja)	x64	ARM64

• platform_type

  Ten opcjonalny argument określa store lub uwp jako typ platformy. Domyślnie środowisko jest ustawione na tworzenie aplikacji klasycznych lub konsolowych.

• winsdk_version

  Opcjonalnie określa wersję zestawu SDK Windows do użycia. Domyślnie jest używany najnowszy zainstalowany zestaw SDK Windows. Aby określić wersję zestawu SDK Windows, użyj pełnego numeru zestawu SDK Windows, takiego jak 10.0.10240.0, lub określ 8.1, aby użyć zestawu SDK Windows 8.1.

• vcversion

  Opcjonalnie określa zestaw narzędzi kompilatora Visual Studio do użycia. Domyślnie środowisko używa najnowszego zainstalowanego zestawu narzędzi kompilatora Visual Studio. W poniższej tabeli przedstawiono przykładowe vcvars_ver wartości:

  vcvars_ver={value}	Result	Przykład programu VS 2026	Przykład programu VS 2022	Przykład programu VS 2019	Przykład programu VS 2017
  "Preview"	Użyj zestawu narzędzi kompilatora Visual Studio w wersji zapoznawczej.	Supported	Niewspierane	Niewspierane	Niewspierane
  "14.0"	Użyj zestawu narzędzi kompilatora Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Użyj najnowszego zainstalowanego 14.xx.yyyyy zestawu narzędzi.	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Użyj określonego pełnego numeru wersji.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Usuń ten parametr, aby używać bibliotek bez środków zaradczych Spectre. Określ spectre, aby używać bibliotek z zabezpieczeniami przed luką Spectre.

Aby skonfigurować środowisko kompilacji w istniejącym oknie wiersza polecenia

1. W wierszu polecenia użyj polecenia CD, aby zmienić katalog instalacyjny Visual Studio. Na przykład C:\Program Files\Microsoft Visual Studio\18\Professional, jeśli używasz Visual studio 2026. Następnie ponownie użyj polecenia CD , aby przejść do podkatalogu zawierającego pliki poleceń specyficznych dla konfiguracji. W przypadku Visual Studio 2017 i nowszych użyj podkatalogu VC\Auxiliary\Build. W przypadku Visual Studio 2015 użyj podkatalogu VC.

2. Wprowadź polecenie dla preferowanego środowiska deweloperskiego. Aby na przykład utworzyć kod ARM dla platformy UWP na platformie 64-bitowej, użyj najnowszego zestawu sdk Windows i zestawu narzędzi kompilatora Visual Studio, użyj następującego polecenia:

   vcvarsall.bat amd64_arm uwp
   

Tworzenie własnego skrótu wiersza polecenia

Otwórz okno dialogowe Właściwości skrótu wiersza polecenia dla dewelopera, aby wyświetlić używany element docelowy polecenia. Na przykład element docelowy skrótu Wiersz polecenia dewelopera dla programu VS 2022 jest podobny do następującego:

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

Pliki wsadowe specyficzne dla architektury ustawiają parametr architecture i wywołują vcvarsall.bat. Możesz przekazać tym plikom wsadowym takie same opcje, jak do vcvarsall.bat, lub po prostu wywołać vcvarsall.bat bezpośrednio. Aby określić parametry dla własnego skrótu polecenia, dodaj je na końcu polecenia w cudzysłowach podwójnych. Aby użyć wcześniejszego zestawu narzędzi kompilatora, określ numer wersji.

Platformę docelową ARM64 można ustawić dopiero od programu Visual Studio 2026, ponieważ usunięto wtedy obsługę platformy docelowej ARM32.

Oto skrót do kompilowania kodu ARM64 dla platformy UWP na platformie 64-bitowej przy użyciu najnowszego zestawu SDK Windows. Opcja ARM64 jest wyświetlana w programie Visual Studio 2026 i nowszych wersjach. Obsługa architektury ARM32 jest pokazana dla wcześniejszych wersji.

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

Dostosuj ścieżkę, aby odzwierciedlić katalog instalacyjny Visual Studio. Plik vcvarsall.bat zawiera więcej informacji na temat określonych numerów wersji.

Narzędzia wiersza polecenia

Aby utworzyć projekt C/C++ w wierszu polecenia, Visual Studio udostępnia następujące narzędzia wiersza polecenia:

• CL

  Kompilator (cl.exe) służy do kompilowania i łączenia plików kodu źródłowego z aplikacjami, bibliotekami i bibliotekami DLL.

• Link

  Użyj konsolidatora (link.exe), aby połączyć skompilowane pliki obiektów i biblioteki w aplikacjach i bibliotekach DLL.

W przypadku kompilacji w wierszu polecenia polecenie F1 nie jest dostępne w celu uzyskania natychmiastowej pomocy. Zamiast tego możesz użyć wyszukiwarki, aby uzyskać informacje o ostrzeżeniach, błędach i komunikatach. Możesz również pobrać i użyć plików pomocy w trybie offline. Aby użyć wyszukiwania w usłudze Microsoft Learn, wprowadź zapytanie w polu wyszukiwania w górnej części dowolnego artykułu.

Narzędzia do zarządzania projektami wiersza polecenia

Domyślnie Visual Studio IDE używa natywnych systemów kompilacji projektów opartych na programie MSBuild. Program MSBuild można wywoływać bezpośrednio w celu kompilowania projektów bez korzystania ze środowiska IDE. Możesz również użyć polecenia devenv, aby użyć Visual Studio do kompilowania projektów i rozwiązań. Visual Studio obsługuje również systemy kompilacji oparte na narzędziach CMake lub NMake.

• MSBuild

  Użyj programu MSBuild (msbuild.exe) i pliku projektu (.vcxproj), aby skonfigurować kompilację i wywołać zestaw narzędzi bez ładowania Visual Studio IDE. Jest to równoważne uruchomieniu Build projektu lub Build Solution w Visual Studio IDE. Program MSBuild ma przewagę nad środowiskiem IDE podczas kompilacji w wierszu polecenia. Nie trzeba instalować pełnego środowiska IDE na wszystkich serwerach kompilacji i potokach kompilacji. Unikasz dodatkowych obciążeń związanych ze środowiskiem IDE. Program MSBuild działa w konteneryzowanych środowiskach kompilacji i obsługuje rejestrator binarny.

• DEVENV

  Użyj DEVENV (devenv.exe) w połączeniu z przełącznikiem wiersza polecenia, takim jak /Build lub /Clean, aby wykonać określone polecenia kompilacji bez wyświetlania Visual Studio IDE.

• CMake

  CMake (cmake.exe) to międzyplatformowe narzędzie typu open source służące do definiowania procesów kompilacji uruchamianych na wielu platformach. Narzędzie CMake może konfigurować i kontrolować natywne narzędzia kompilacji dla obsługiwanych platform, takich jak MSBuild i Make. Aby uzyskać więcej informacji na temat narzędzia CMake, zobacz dokumentację narzędzia CMake.

• NMAKE

  Użyj narzędzia NMAKE (nmake.exe) do kompilowania projektów języka C++ przy użyciu tradycyjnego pliku make.

Uwaga

Począwszy od Visual Studio 2019 w wersji 16.5, msBuild i DEVENV nie używają środowiska wiersza polecenia do kontrolowania używanego zestawu narzędzi i bibliotek.

Zobacz też

• Przewodnik: kompilowanie natywnego programu C++ w wierszu polecenia
• Przewodnik: kompilowanie programu w języku C w wierszu polecenia
• Przewodnik: kompilowanie programu C++/CLI w wierszu polecenia
• Przewodnik: kompilowanie programu C++/CX w wierszu polecenia
• Projekty i systemy kompilacji
• /MD, /MT, /LD (Użyj biblioteki czasu wykonywania)
• Opcje kompilatora C/C++
• Opcje linkera MSVC
• Dodatkowe narzędzia do budowania MSVC