Verwenden der Microsoft C++-Buildtools über die Befehlszeile

Sie können C- und C++-Anwendungen auf der Befehlszeile erstellen, indem Sie Tools verwenden, die in Visual Studio enthalten sind. Sie können auch die Microsoft C++-Buildtools (MSVC) als eigenständiges Paket herunterladen. Sie müssen die Visual Studio-IDE nicht installieren, wenn Sie dies nicht planen.

Herunterladen und Installieren der Tools

Verwenden der Befehlszeilentools

Wenn Sie eine der C++-Workloads im Visual Studio Installer auswählen, wird standardmäßig eine bestimmte Version des MSVC Build Tools-Pakets installiert. Für Visual Studio 2022 und früheren Versionen wird das Paket von einem platform-Toolset (v###-Versionsformat) organisiert, das alle C- und C++-Tools für eine bestimmte Version von Visual Studio enthält. Für spätere Versionen von Visual Studio besteht das Paket aus der MSVC-Version (v#.###-Versionsformat), die alle C- und C++-Tools für dieses bestimmte MSVC-Paket enthält. Die MSVC-Version wird von der Visual Studio Version entkoppelt.

Zu den Tools gehören die C/C++-Compiler, Linker, Assembler und andere Buildtools. Es enthält übereinstimmende Bibliotheken und Headerdateien. Sie können alle diese Tools in der Befehlszeile verwenden. Die Visual Studio-IDE verwendet sie intern. Es gibt separate x86-gehostete und x64-gehostete Compiler und Tools, die Code für x86-, x64-, ARM- und ARM64-Ziele erstellen. Jeder Satz Tools für eine bestimmte Host- und Zielbuildarchitektur ist in einem eigenen Verzeichnis gespeichert.

Damit die Tools ordnungsgemäß funktionieren, müssen mehrere Umgebungsvariablen festgelegt werden. Diese Variablen fügen die Tools dem Pfad hinzu und legen die Speicherorte von Include-Dateien, Bibliotheksdateien und SDKs fest. Um das Festlegen dieser Umgebungsvariablen zu vereinfachen, erstellt der Installer während der Installation angepasste Befehlsdateien oder Batchdateien. Sie können eine dieser Befehlsdateien ausführen, um eine bestimmte Host- und Zielbuildarchitektur, Windows SDK-Version und Plattformtoolset festzulegen.

Aus praktischer Gründen erstellt das Installationsprogramm auch Verknüpfungen im Startmenü. Die Tastenkombinationen öffnen Entwickler-Eingabeaufforderungsfenster mithilfe dieser Befehlsdateien für bestimmte Kombinationen von Host und Ziel. Diese Verknüpfungen stellen sicher, dass alle erforderlichen Umgebungsvariablen festgelegt und einsatzbereit sind.

Die erforderlichen Umgebungsvariablen sind für Ihre Installation und für die von Ihnen gewählte Buildarchitektur spezifisch. Produktupdates oder -upgrades können die Variablen ändern. Diese Abweichung ist ein Grund, warum wir Ihnen empfehlen, eine installierte Eingabeaufforderung-Tastenkombination oder eine Befehlsdatei zu verwenden, anstatt die Umgebungsvariablen selbst festzulegen.

Die Toolsets, Befehlsdateien und Verknüpfungen, die vom Installationsprogramm hinzugefügt werden, hängen vom Computerprozessor und den Optionen ab, die Sie während der Installation auswählen. Die in x86-Systemen gehosteten Tools und Cross Tools, die x86-und x64-Code erstellen, sind immer installiert. Wenn Sie über 64-Bit-Windows verfügen, werden auch die von x64 gehosteten Tools und Kreuztools installiert, die x86- und x64-Code erstellen. Wenn Sie die optionalen C++-Universelle Windows-Plattform-Tools auswählen, werden auch die x86- und x64-Tools installiert, die ARM- und ARM64-Code erstellen. Andere Workloads können diese Tools installieren.

Pfad- und Umgebungsvariablen für Befehlszeilenbuilds

Die MSVC-Befehlszeilentools verwenden die Umgebungsvariablen PATH, TMP, INCLUDE, LIB und LIBPATH. Sie verwenden auch andere Umgebungsvariablen, die für Ihre installierten Tools, Plattformen und SDKs spezifisch sind. Selbst eine einfache Visual Studio Installation kann zwanzig oder mehr Umgebungsvariablen festlegen. Diese Komplexität ist der Grund, warum wir Ihnen dringend empfehlen, eine Developer-Eingabeaufforderung-Tastenkombination oder eine der angepassten Befehlsdateien zu verwenden. Es wird nicht empfohlen, diese Variablen in der Windows Umgebung selbst festzulegen.

Verwenden Sie den Befehl SET, um anzuzeigen, welche Umgebungsvariablen eine Verknüpfung für die Entwickler-Eingabeaufforderung festlegt. Öffnen Sie ein normales Eingabeaufforderungsfenster, und erfassen Sie die Ausgabe des Befehls SET als Basiswert. Öffnen Sie ein Developer Command Prompt-Fenster, und erfassen Sie zum Vergleich die Ausgabe des Befehls SET. Verwenden Sie ein Diff-Tool, z. B. das in Visual Studio integrierte Tool, um die von der Entwickler-Eingabeaufforderung festgelegten Umgebungsvariablen hervorzuheben. Weitere Informationen über die Compiler- und Linker-Umgebungsvariablen finden Sie unter CL-Umgebungsvariablen.

Developer-Eingabeaufforderungsverknüpfungen

Die Eingabeaufforderungsverknüpfungen werden in einem versionsspezifischen Visual Studio-Ordner im Windows-Startmenü gespeichert. Das Folgende ist eine Liste der grundlegenden Eingabeaufforderungsverknüpfungen und der von ihnen unterstützten Buildarchitekturen:

• Eingabeaufforderung für Entwickler. Legt die Umgebung so fest, dass 32-Bit-, x86-systemeigene Tools zum Erstellen von 32-Bit-, x86-nativem Code verwendet werden.
• X86 Native Tools -Eingabeaufforderung. Legt die Umgebung so fest, dass 32-Bit-, x86-systemeigene Tools zum Erstellen von 32-Bit-, x86-nativem Code verwendet werden.
• X64 Native Tools -Eingabeaufforderung. Legt die Umgebung so fest, dass 64-Bit-, x64-systemeigene Tools zum Erstellen von 64-Bit-, x64-systemeigenem Code verwendet werden.
• x86_x64 Eingabeaufforderung für Cross-Tools. Legt die Umgebung so fest, dass 32-Bit-, x86-native Tools zum Erstellen von 64-Bit-, x64-systemeigenem Code verwendet werden.
• Eingabeaufforderung für x64_x86-Cross-Tools. Legt die Umgebung so fest, dass 64-Bit-, x64-native Tools zum Erstellen von 32-Bit-, x86-nativem Code verwendet werden.

So öffnen Sie ein Entwickler-Eingabeaufforderungsfenster

1. Öffnen Sie auf dem Desktop das Menü Windows Start. Wählen Sie in Windows 11 Alle Apps aus, um die Liste der installierten Apps zu öffnen. In Windows 10 ist die Liste links geöffnet. Scrollen Sie in der Liste nach unten, um den Ordner (nicht die App) für Ihre Version von Visual Studio zu suchen und zu öffnen, z. B. Visual Studio 2022.

2. Wählen Sie im Ordner die Developer-Eingabeaufforderung für Ihre Version von Visual Studio aus. Diese Verknüpfung startet ein Eingabeaufforderungsfenster für Entwickler, das die standardmäßige Buildarchitektur von 32-Bit-, x86-nativen Tools zum Erstellen von 32-Bit-, x86-systemeigenem Code verwendet. Wenn Sie eine nicht standardmäßige Buildarchitektur bevorzugen, wählen Sie eine der systemeigenen oder toolsübergreifenden Eingabeaufforderungen aus, um die Host- und Zielarchitektur anzugeben.

Sogar noch schneller lässt sich eine Developer-Eingabeaufforderung öffnen, wenn Sie Developer-Eingabeaufforderung in das Suchfeld auf dem Desktop eingeben. Wählen Sie dann das gewünschte Ergebnis aus.

Speicherorte von Developer-Befehlsdateien

Wenn Sie die Buildumgebung lieber in einem vorhandenen Eingabeaufforderungsfenster festlegen möchten, können Sie eine der vom Installationsprogramm erstellten Befehlsdateien verwenden. Es wird empfohlen, die Umgebung in einem neuen Eingabeaufforderungsfenster festzulegen. Wir raten davon ab, später im gleichen Befehlsfenster die Umgebung zu wechseln.

Die Befehlsdatei der primären Entwickler-Eingabeaufforderung, VsDevCmd.bat, befindet sich im Common7\Tools-Verzeichnis. Wenn Sie keine Parameter angeben, wird die Umgebung so festgelegt, dass die x86-nativen Tools zum Erstellen von 32-Bit-x86-Code verwendet werden.

Diese Befehlsdateien legen Standardparameter fest und rufen VsDevCmd.bat auf, um die angegebene Build-Architektur-Umgebung einzurichten. Eine typische Installation kann folgende Befehlsdateien enthalten:

Verwenden der Entwicklertools in einem vorhandenen Befehlsfenster

Der einfachste Weg, eine bestimmte Build-Architektur in einem bestehenden Befehlsfenster anzugeben, ist die Nutzung der vcvarsall.bat Datei. Verwenden Sie vcvarsall.bat, um Umgebungsvariablen festzulegen und das Fenster der Eingabeaufforderung für die native 32-Bit- oder 64-Bit-Kompilierung zu konfigurieren. Mit Argumenten können Sie die Kreuzkompilierung für x86-, x64-, ARM- oder ARM64-Prozessoren angeben. Sie können auf Microsoft Store-, Universelle Windows-Plattform- oder Windows Desktopplattformen abzielen. Sie können sogar angeben, welche Windows SDK verwendet werden soll, und die Plattformtoolsetversion auswählen.

Wenn Sie vcvarsall.bat ohne Argumente verwenden, werden die Umgebungsvariablen so konfiguriert, dass der aktuelle x86-native Compiler für 32-Bit-Windows Desktopziele verwendet wird. Fügen Sie Argumente hinzu, um die Umgebung so zu konfigurieren, dass sie eines der systemeigenen oder compilerübergreifenden Tools verwendet. vcvarsall.bat zeigt eine Fehlermeldung an, wenn Sie eine Konfiguration angeben, die nicht installiert ist oder auf Ihrem Computer nicht verfügbar ist.

vcvarsall-Syntax

vcvarsall.bat architecture platform_type winsdk_version -vcvars_ver= vcversion spectre_mode

• architecture

  Dieses optionale Argument gibt die zu verwendende Host- und Zielarchitektur an. Wenn Sie nicht angeben architecture, wird die Standardbuildumgebung verwendet. Die folgenden Argumente werden unterstützt:

  architecture	Compiler	Hostcomputerarchitektur	Buildausgabearchitektur (Zielarchitektur)
  x86	x86-32-Bit systemeigen	x86, x64	x86
  x86_amd64 oder x86_x64	x64 kreuzkompatibel auf x86	x86, x64	x64
  x86_arm	ARM auf x86-Cross	x86, x64	ARM
  x86_arm64	ARM64 kreuzkompatibel auf x86	x86, x64	ARM64
  amd64 oder x64	x64 64-Bit nativ	x64	x64
  amd64_x86 oder x64_x86	x86 kreuzkompatibel auf x64	x64	x86
  amd64_arm oder x64_arm	ARM kreuzkompatibel auf x64	x64	ARM
  amd64_arm64 oder x64_arm64	ARM64 kreuzkompatibel auf x64	x64	ARM64

• platform_type

  Dieses optionale Argument gibt store oder uwp als Plattformtyp an. Standardmäßig ist die Umgebung auf das Erstellen von Desktop- oder Konsolen-Apps festgelegt.

• winsdk_version

  Gibt optional die version des zu verwendenden Windows SDK an. Standardmäßig wird das neueste installierte Windows SDK verwendet. Um die Windows SDK-Version anzugeben, verwenden Sie eine vollständige Windows SDK-Nummer wie 10.0.10240.0, oder geben Sie 8.1 an, um das Windows 8.1 SDK zu verwenden.

• vcversion

  Gibt optional das zu verwendende Compilertoolset Visual Studio an. Standardmäßig ist die Umgebung so festgelegt, dass das aktuelle Visual Studio Compilertoolset verwendet wird.

  Verwenden Sie -vcvars_ver=14.2x.yyyyy, um eine bestimmte Version des Compilertoolsets Visual Studio 2019 anzugeben.

  Verwenden Sie -vcvars_ver=14.29, um die neueste Version des Compilertoolsets Visual Studio 2019 anzugeben.

  Verwenden Sie -vcvars_ver=14.16, um die neueste Version des Compilertoolsets Visual Studio 2017 anzugeben.

  Verwenden Sie -vcvars_ver=14.1x.yyyyy, um eine bestimmte Version des Compilertoolsets Visual Studio 2017 anzugeben.

  Verwenden Sie -vcvars_ver=14.0, um das Visual Studio 2015-Compilertoolset anzugeben.

• spectre_mode

  Lassen Sie diesen Parameter aus, um Bibliotheken ohne Spectre-Ausgleich zu verwenden. Verwenden Sie den Wert spectre, um Bibliotheken mit Spectre-Risikominderungen zu nutzen.

So richten Sie die Buildumgebung in einem vorhandenen Eingabeaufforderungsfenster ein

1. Verwenden Sie an der Eingabeaufforderung den Befehl CD, um zum Visual Studio Installationsverzeichnis zu wechseln. Verwenden Sie CD dann erneut, um in das Unterverzeichnis zu wechseln, das die konfigurationsspezifischen Befehlsdateien enthält. Verwenden Sie für Visual Studio 2019 und Visual Studio 2017 das Unterverzeichnis VC\Auxiliary\Build. Verwenden Sie für Visual Studio 2015 das Unterverzeichnis VC.

2. Geben Sie den Befehl für Ihre bevorzugte Entwicklerumgebung ein. Um beispielsweise ARM-Code für UWP auf einer 64-Bit-Plattform zu erstellen, verwenden Sie den folgenden Befehl, indem Sie das neueste Windows SDK und Visual Studio Compilertoolset verwenden:

   vcvarsall.bat amd64_arm uwp
   

Erstellen einer eigenen Eingabeaufforderungsverknüpfung

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

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

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

Die architekturspezifischen Batchdateien setzen den architecture-Parameter und rufen vcvarsall.bat auf. Sie können dieselben Optionen an diese Batchdateien übergeben, wie Sie sie an vcvarsall.bat übergeben, oder Sie können vcvarsall.bat einfach direkt aufrufen. Um Parameter für Ihre eigene Befehlsverknüpfung anzugeben, fügen Sie sie am Ende des Befehls in doppelten Anführungszeichen hinzu. Hier ist beispielsweise ein Schnellzugriff zum Erstellen von ARM-Code für UWP auf einer 64-Bit-Plattform unter Verwendung des neuesten Windows SDKs. Wenn Sie ein früheres Compilertoolset verwenden möchten, geben Sie die Versionsnummer an. Verwenden Sie einen Befehl wie dieses Befehlsziel in Ihrer Verknüpfung:

%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

Passen Sie den Pfad an, um Ihr Visual Studio Installationsverzeichnis widerzuspiegeln. Die vcvarsall.bat Datei enthält zusätzliche Informationen zu bestimmten Versionsnummern.

Befehlszeilentools

Um ein C/C++-Projekt an einer Eingabeaufforderung zu erstellen, stellt Visual Studio die folgenden Befehlszeilentools bereit:

• CL

  Verwenden Sie den Compiler (cl.exe), um Quellcodedateien in Apps, Bibliotheken und DLLs zu kompilieren und zu verknüpfen.

• Link

  Verwenden Sie den Linker (link.exe), um kompilierte Objektdateien und -bibliotheken mit Apps und DLLs zu verknüpfen.

Wenn Sie Builds über die Befehlszeile ausführen, ist der F1-Befehl für Soforthilfe nicht verfügbar. Stattdessen können Sie eine Suchmaschine verwenden, um Informationen zu Warnungen, Fehlern und Meldungen abzurufen. Sie können auch die Offlinehilfedateien herunterladen und verwenden. Um die Suche in Microsoft Lernen zu verwenden, geben Sie Ihre Abfrage in das Suchfeld oben in einem beliebigen Artikel ein.

Befehlszeilentools für die Projektverwaltung

Standardmäßig verwendet die Visual Studio-IDE systemeigene Projektbuildsysteme, die auf MSBuild basieren. Sie können MSBuild direkt aufrufen, um Projekte ohne Verwendung der IDE zu erstellen. Sie können auch den Befehl devenv verwenden, um Visual Studio zum Erstellen von Projekten und Lösungen zu verwenden. Visual Studio unterstützt auch Buildsysteme, die auf CMake oder NMake basieren.

• MSBuild

  Verwenden Sie MSBuild (msbuild.exe) und eine Projektdatei (.vcxproj), um einen Build zu konfigurieren und das Toolset aufzurufen, ohne die Visual Studio-IDE zu laden. Es entspricht dem Ausführen des Build Projekts oder Build Solution Befehls im Visual Studio-IDE. MSBuild hat gegenüber der IDE Vorteile, wenn Sie an der Befehlszeile erstellen. Sie müssen nicht die vollständige IDE auf allen Ihren Buildservern und Buildpipelines installieren. Sie vermeiden den zusätzlichen Mehraufwand der IDE. MSBuild wird in containerisierten Buildumgebungen ausgeführt und unterstützt eine binäre Protokollierung.

• DEVENV

  Verwenden Sie DEVENV (devenv.exe) in Kombination mit einem Befehlszeilenschalter wie /Build oder /Clean, um bestimmte Buildbefehle auszuführen, ohne die Visual Studio-IDE anzuzeigen.

• CMake

  CMake (cmake.exe) ist ein plattformübergreifendes Open-Source-Tool zum Definieren von Buildprozessen, die auf mehreren Plattformen ausgeführt werden. CMake kann native Buildtools für die unterstützten Plattformen wie MsBuild oder NMake konfigurieren und steuern. Weitere Informationen zu CMake finden Sie in der CMake-Dokumentation.

• NMAKE

  Verwenden Sie NMAKE () zum Erstellen von C++-Projekten mithilfe einer herkömmlichen Makefile.Use NMAKE (nmake.exe) to build C++projects by using a traditional makefile.

Weitere Informationen

• Durchführung: Ein natives C++-Programm auf der Befehlszeile kompilieren
• Durchgang: Kompilieren eines C-Programms auf der Befehlszeile
• Durchgang: Kompilieren eines C++/CLI-Programms auf der Befehlszeile
• Durchgang: Kompilieren eines C++/CX-Programms auf der Befehlszeile
• Projekte und Erstellungsysteme
• /MD, /MT, /LD Laufzeitbibliothek verwenden
• C/C++-Compileroptionen
• MSVC Linker-Optionen
• Zusätzliche MSVC-Buildtools