Använd Microsoft C++-verktygsuppsättningen från kommandoraden

Du kan skapa C- och C++-program på kommandoraden med hjälp av verktyg som ingår i Visual Studio. Kompilatorverktygen för Microsoft C++ (MSVC) kan också laddas ned som ett fristående paket. Du behöver inte installera Visual Studio IDE om du inte planerar att använda den.

Anmärkning

Den här artikeln handlar om hur du konfigurerar en miljö för att använda enskilda kompilatorer, länkare, bibliotekarier och andra grundläggande verktyg. Det inbyggda projektbyggsystemet i Visual Studio, baserat på MSBuild, använder inte miljön enligt beskrivningen i den här artikeln. Mer information om hur du använder MSBuild från kommandoraden finns i MSBuild på kommandoraden - C++.

Ladda ned och installera verktygen

Om du har installerat Visual Studio och en C++-arbetsbelastning har du alla kommandoradsverktyg. Information om hur du installerar C++ och Visual Studio finns i Installera C++-stöd i Visual Studio. Om du bara vill ha kommandoradsverktygen laddar du ned Build Tools för Visual Studio. När du kör den nedladdade körbara filen uppdateras och körs Visual Studio Installer. Om du bara vill installera de verktyg du behöver för C++-utveckling väljer du Skrivbordsutveckling med C++ -arbetsbelastning. Du kan välja valfria bibliotek och verktygsuppsättningar som ska ingå under Installationsinformation. Om du vill skapa kod med hjälp av verktygsuppsättningarna Visual Studio 2015, 2017 eller 2019 väljer du de valfria versionsverktygen MSVC v140, v141 eller v142. När du är nöjd med dina val väljer du Installera.

Så här använder du kommandoradsverktygen

När du väljer en av C++-arbetsbelastningarna i Visual Studio Installer installeras Visual Studio-plattformsverktyguppsättningen. En plattformsverktyguppsättning har alla C- och C++-verktyg för en specifik Visual Studio-version. Verktygen omfattar C/C++-kompilatorer, länkare, assemblers och andra byggverktyg samt matchande bibliotek och huvudfiler. Du kan använda alla dessa verktyg på kommandoraden. De används också internt av Visual Studio IDE. Det finns olika x86- och x64-hostade kompilatorer och verktyg för att skapa kod för x86-, x64-, ARM- och ARM64-mål. Varje uppsättning verktyg för en viss värd- och målarkitektur lagras i en egen katalog.

För att fungera korrekt kräver verktygen att flera specifika miljövariabler anges. Dessa variabler används för att lägga till verktygen i sökvägen och att ange placeringar av inkluderingsfiler, biblioteksfiler och SDK:er. För att göra det enkelt att ange dessa miljövariabler skapar installationsprogrammet anpassade kommandofiler eller batchfiler under installationen. Du kan köra en av dessa kommandofiler för att ange en specifik arkitektur för värd- och målbygge, Windows SDK-version och plattformsverktyg. För enkelhetens skull skapar installationsprogrammet även genvägar i Start-menyn. Genvägarna öppnar utvecklarkommandoprompten genom att använda dessa kommandofiler för vissa kombinationer av värd och målenhet. Dessa genvägar säkerställer att alla nödvändiga miljövariabler är inställda och redo att användas.

De miljövariabler som krävs är specifika för din installation och för den byggarkitektur som du väljer. De kan också ändras av produktuppdateringar eller uppgraderingar. Den här variabiliteten är en anledning till att vi rekommenderar att du använder en installerad genväg eller kommandofil för kommandotolken, i stället för att ställa in miljövariablerna själv.

De installerade verktygsuppsättningarna, kommandofilerna och genvägarna beror på datorprocessorn och de alternativ som du valde under installationen. X86-värdbaserade verktyg och korsverktyg som skapar x86- och x64-kod installeras alltid. Om du har 64-bitars Windows installeras även de x64-värdbaserade verktygen och korsverktygen som skapar x86- och x64-kod. Om du väljer de valfria C++ Universal Windows Platform-verktygen installeras även x86- och x64-verktygen som skapar ARM- och ARM64-kod. Andra arbetsbelastningar kan installera dessa och andra verktyg.

Sökvägs- och miljövariabler för kommandoradsversioner

MSVC-kommandoradsverktygen PATHanvänder miljövariablerna , TMP, INCLUDE, LIBoch LIBPATH och använder även andra miljövariabler som är specifika för dina installerade verktyg, plattformar och SDK:er. Även en enkel Visual Studio-installation kan ange tjugo eller fler miljövariabler. Den här komplexiteten är anledningen till att vi starkt rekommenderar att du använder en genväg till kommandotolken för utvecklare eller någon av de anpassade kommandofilerna. Vi rekommenderar inte att du ställer in dessa variabler i Windows-miljön själv.

Om du vill se vilka miljövariabler som anges av en genväg till kommandotolken för utvecklare kan du använda SET kommandot . Öppna ett vanligt kommandotolksfönster och samla in utdata från SET kommandot för en baslinje. Öppna kommandotolken för utvecklare och samla in utdata från SET kommandot för jämförelse. Använd ett diff-verktyg, till exempel det som är inbyggt i Visual Studio, för att markera miljövariablerna som anges av kommandotolken för utvecklare. Mer information om miljövariablerna för kompilatorn och länkarna finns i CL-miljövariabler.

Genvägar till kommandotolken för utvecklare

Genvägarna för kommandotolken installeras i en versionsspecifik Visual Studio-mapp på Start-menyn i Windows. Här är en lista över genvägarna för grundläggande kommandotolk och de byggarkitekturer som de stöder:

• Kommandotolken för utvecklare – Anger att miljön ska använda 32-bitars x86-inbyggda verktyg för att skapa 32-bitars, x86-inbyggd kod.
• x86 Native Tools Command Prompt – Anger att miljön ska använda 32-bitars x86-inbyggda verktyg för att skapa 32-bitars, x86-intern kod.
• x64 Native Tools Command Prompt – Anger att miljön ska använda 64-bitars x64-inbyggda verktyg för att skapa 64-bitars, x64-intern kod.
• x86_x64 Kommandotolk för flera verktyg – Anger att miljön ska använda 32-bitars x86-inbyggda verktyg för att skapa 64-bitars, x64-intern kod.
• x64_x86 Kommandotolk för flera verktyg – Anger att miljön ska använda 64-bitars x64-inbyggda verktyg för att skapa 32-bitars, x86-inbyggd kod.

Mappen Start-menyn och genvägsnamnen varierar beroende på den installerade versionen av Visual Studio. Om du anger en beror de också på installationen Smeknamn. Anta till exempel att du har installerat Visual Studio 2022 och gett det ett smeknamn på Senaste. Genvägen till kommandotolken för utvecklare heter Developer Command Prompt for VS 2022 (Latest), i en mapp med namnet Visual Studio 2022.

Anmärkning

Flera kommandoradsverktyg eller verktygsalternativ kan kräva administratörsbehörighet. Om du har behörighetsproblem när du använder dem rekommenderar vi att du öppnar kommandotolken för utvecklare med alternativet Kör som administratör . Högerklicka för att öppna snabbmenyn för kommandotolken och välj sedan Mer, Kör som administratör.

Öppna kommandotolken för utvecklare

1. Öppna Start-menyn i Windows på skrivbordet. I Windows 11 väljer du knappen Alla appar för att öppna listan över installerade appar. I Windows 10 är listan öppen till vänster. Rulla nedåt i listan för att hitta och öppna mappen (inte appen) för din version av Visual Studio, till exempel Visual Studio 2022.

2. I mappen väljer du Developer Command Prompt för din version av Visual Studio. Den här genvägen startar ett kommandotolkfönster för utvecklare som använder standardarkitekturen för 32-bitars x86-inbyggda verktyg för att skapa 32-bitars, x86-inbyggd kod. Om du föredrar en icke-standardversionsarkitektur väljer du en av de interna eller korsverktygskommandona för att ange värd- och målarkitekturen.

Om du vill ha ett ännu snabbare sätt att öppna en kommandotolk för utvecklare anger du kommandotolken för utvecklare i sökrutan för skrivbordet. Välj sedan önskat resultat.

Anmärkning

Som standard är den aktuella arbetskatalogen i en kommandotolk för utvecklare roten till Visual Studio-installationen i katalogen Programfiler. Det här är inte en lämplig plats för din kod och dina projekt. Ändra den aktuella arbetskatalogen till en annan plats innan du skapar ett projekt. IDE skapar projekt i användarkatalogen, vanligtvis i %USERPROFILE%\source\repos.

Platser för utvecklarkommandofiler

Om du föredrar att ange byggmiljön i ett befintligt kommandotolkfönster kan du använda en av kommandofilerna som skapats av installationsprogrammet. Vi rekommenderar att du anger miljön i ett nytt kommandotolksfönster. Vi rekommenderar inte att du senare växlar miljöer i samma kommandofönster.

Platsen för kommandofilen beror på vilken version av Visual Studio du har installerat och på vilka val du gjorde under installationen. För Visual Studio 2019 finns den typiska installationsplatsen i ett 64-bitarssystem i \Program Files\Microsoft Visual Studio\2022\<edition>. Kan <edition> vara Community, Professional, Enterprise, BuildTools eller ett annat smeknamn som du har angett.

Den primära kommandotolken för utvecklare, VsDevCmd.bat, finns i underkatalogen Common7\Tools . När inga parametrar anges anger den miljön att använda x86-inbyggda verktyg för att skapa 32-bitars x86-kod.

Det finns fler kommandofiler tillgängliga för att konfigurera specifika byggarkitekturer. Vilka kommandofiler som är tillgängliga beror på vilka Visual Studio-arbetsbelastningar och alternativ som du har installerat. I Visual Studio 2017 och Visual Studio 2019 hittar du dem i underkatalogen VC\Auxiliary\Build.

Dessa kommandofiler anger standardparametrar och anropar VsDevCmd.bat för att konfigurera den angivna byggarkitekturmiljön. En typisk installation kan innehålla följande kommandofiler:

Kommandofil	Värd- och målarkitekturer
vcvars32.bat	Använd 32-bitars x86-inbyggda verktyg för att skapa 32-bitars x86-kod.
vcvars64.bat	Använd 64-bitars x64-inbyggda verktyg för att skapa 64-bitars x64-kod.
vcvarsx86_amd64.bat	Använd 32-bitars x86-inbyggda korsverktyg för att skapa 64-bitars x64-kod.
vcvarsamd64_x86.bat	Använd 64-bitars x64-inbyggda korsverktyg för att skapa 32-bitars x86-kod.
vcvarsx86_arm.bat	Använd 32-bitars x86-inbyggda korsverktyg för att skapa ARM-kod.
vcvarsamd64_arm.bat	Använd 64-bitars x64-inbyggda korsverktyg för att skapa ARM-kod.
vcvarsx86_arm64.bat	Använd 32-bitars x86-inbyggda korsverktyg för att skapa ARM64-kod.
vcvarsamd64_arm64.bat	Använd 64-bitars x64-inbyggda korsverktyg för att skapa ARM64-kod.
vcvarsall.bat	Använd parametrar för att ange värd- och målarkitekturer, Windows SDK och plattformsalternativ. För en lista över alternativ som stöds anropar du med hjälp av en /help parameter.

Försiktighet

Filen vcvarsall.bat och andra Visual Studio-kommandofiler kan variera från dator till dator. Ersätt inte en fil som saknas eller är skadad vcvarsall.bat med hjälp av en fil från en annan dator. Kör installationsprogrammet för Visual Studio igen för att ersätta den saknade filen.

Filen vcvarsall.bat varierar också från version till version. Om den aktuella versionen av Visual Studio är installerad på en dator som också har en tidigare version av Visual Studio ska du inte köra eller någon vcvarsall.bat annan Visual Studio-kommandofil från olika versioner i samma kommandotolkfönster.

Använda utvecklarverktygen i ett befintligt kommandofönster

Det enklaste sättet att ange en viss byggarkitektur i ett befintligt kommandofönster är att använda vcvarsall.bat filen. Använd vcvarsall.bat för att ange miljövariabler för att konfigurera kommandoraden för intern 32-bitars eller 64-bitars kompilering. Med argument kan du ange korskompilering till x86-, x64-, ARM- eller ARM64-processorer. Du kan rikta dig mot Microsoft Store, Universal Windows Platform eller Windows Desktop. Du kan till och med ange vilken Windows SDK som ska användas och välja plattformsverktygsuppsättningens version.

När de används utan argument vcvarsall.bat konfigurerar miljövariablerna att använda den aktuella x86-inbyggda kompilatorn för 32-bitars Windows Desktop-mål. Du kan lägga till argument för att konfigurera miljön så att den använder något av de interna eller korskompileringsverktygen. vcvarsall.bat visar ett felmeddelande om du anger en konfiguration som inte är installerad eller inte tillgänglig på datorn.

vcvarsall syntax

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

architecture
Det här valfria argumentet anger vilken värd- och målarkitektur som ska användas. Om arkitekturen inte har angetts används standardmiljön för bygget. Dessa argument stöds:

architecture	Kompilator	Värddatorarkitektur	Arkitektur för att skapa utdata (mål)
x86	x86 32-bit inbyggd	x86, x64	x86
x86_amd64 eller x86_x64	x64 på x86 korskompilation	x86, x64	x64
x86_arm	ARM i x86-kompatibilitet	x86, x64	ARM
x86_arm64	ARM64 på x86-korsplattform	x86, x64	ARM64
amd64 eller x64	x64 64-bit nativ	x64	x64
amd64_x86 eller x64_x86	x86 på x64 korskompabilitet	x64	x86
amd64_arm eller x64_arm	ARM på x64-kors	x64	ARM
amd64_arm64 eller x64_arm64	ARM64 på x64-kors	x64	ARM64

platform_type
Med det här valfria argumentet kan du ange store eller uwp som plattformstyp. Som standard är miljön inställd på att skapa skrivbords- eller konsolappar.

winsdk_version
Du kan också ange vilken version av Windows SDK som ska användas. Som standard används den senaste installerade Windows SDK:en. Om du vill ange Windows SDK-versionen kan du använda ett fullständigt Windows SDK-nummer, till exempel 10.0.10240.0, eller ange 8.1 för att använda Windows 8.1 SDK.

vcversion
Du kan också ange den Visual Studio-kompilatorverktyguppsättning som ska användas. Som standard är miljön inställd på att använda den aktuella Visual Studio-kompilatorverktyguppsättningen.

Använd -vcvars_ver=14.2x.yyyyyy för att ange en specifik version av kompileringsverktygen för Visual Studio 2019.

Använd -vcvars_ver=14.29 för att ange den senaste versionen av kompileringsverktygen för Visual Studio 2019.

Använd -vcvars_ver=14.0 för att ange verktygsuppsättningen för Visual Studio 2015-kompilatorn.

spectre_mode
Utelämna den här parametern för att använda bibliotek utan Spectre-åtgärder. Använd värdet spectre för att använda bibliotek med Spectre-skydd.

Så här konfigurerar du byggmiljön i ett befintligt kommandotolkfönster

1. I kommandotolken använder du CD-kommandot för att ändra till Visual Studio-installationskatalogen. Använd sedan CD igen för att ändra till den underkatalog som innehåller de konfigurationsspecifika kommandofilerna. För Visual Studio 2019 och Visual Studio 2017 använder du underkatalogen VC\Auxiliary\Build . För Visual Studio 2015 använder du VC-underkatalogen.

2. Ange kommandot för önskad utvecklarmiljö. Om du till exempel vill skapa ARM-kod för UWP på en 64-bitarsplattform använder du den senaste verktygsuppsättningen för Windows SDK och Visual Studio-kompilatorn:

   vcvarsall.bat amd64_arm uwp

Skapa en egen genväg till kommandotolken

Öppna dialogrutan Egenskaper för en genväg till kommandotolken för utvecklare för att se vilket kommandomål som används. Till exempel är måladressen för genvägen x64 Native Tools Command Prompt för VS 2019 något liknande:

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

De arkitekturspecifika batchfilerna anger parametern architecture och anropar vcvarsall.bat. Du kan skicka samma alternativ till dessa batchfiler som du skulle skicka till vcvarsall.bat, eller så kan du bara anropa vcvarsall.bat direkt. Om du vill ange parametrar för din egen kommandogenväg lägger du till dem i slutet av kommandot med dubbla citattecken. Här är till exempel en genväg för att skapa ARM-kod för UWP på en 64-bitarsplattform med hjälp av den senaste Windows SDK:t. Om du vill använda en tidigare kompilatorverktyguppsättning anger du versionsnumret. Använd något som liknar det här kommandomålet i genvägen:

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

Justera sökvägen så att den återspeglar Visual Studio-installationskatalogen. Filen vcvarsall.bat innehåller ytterligare information om specifika versionsnummer.

Kommandoradsverktyg

Visual Studio tillhandahåller följande kommandoradsverktyg för att skapa ett C/C++-projekt i en kommandotolk:

CL
Använd kompilatorn (cl.exe) för att kompilera och länka källkodsfiler till appar, bibliotek och DLL:er.

Link
Använd länkaren (link.exe) för att länka kompilerade objektfiler och bibliotek till appar och DLL:er.

När du skapar på kommandoraden är F1-kommandot inte tillgängligt för omedelbar hjälp. I stället kan du använda en sökmotor för att få information om varningar, fel och meddelanden. Du kan också ladda ned och använda offlinehjälpfilerna. Om du vill använda sökningen i Microsoft Learn anger du din fråga i sökrutan överst i en artikel.

Verktyg för kommandoradsprojekthantering

Visual Studio IDE använder som standard inbyggda projektbyggsystem baserade på MSBuild. Du kan anropa MSBuild direkt för att skapa projekt utan att använda IDE. Du kan också använda devenv kommandot för att använda Visual Studio för att skapa projekt och lösningar. Visual Studio stöder även byggsystem baserade på CMake eller NMake.

MSBuild
Använd MSBuild (msbuild.exe) och en projektfil (.vcxproj) för att konfigurera en version och anropa verktygsuppsättningen utan att läsa in Visual Studio IDE. Det motsvarar att köra kommandot Build project eller Build Solution i Visual Studio IDE. MSBuild har fördelar jämfört med IDE när du skapar på kommandoraden. Du behöver inte installera den fullständiga IDE:en på alla byggservrar och bygg-pipelines. Du undviker extra kostnader för IDE. MSBuild körs i containerbaserade byggmiljöer och stöder en binär loggning.

DEVENV
Använd DEVENV (devenv.exe) kombinerat med en kommandoradsväxel, till exempel /Build eller /Clean för att köra vissa byggkommandon utan att visa Visual Studio IDE.

CMake
CMake (cmake.exe) är ett plattformsoberoende verktyg med öppen källkod för att definiera byggprocesser som körs på flera plattformar. CMake kan konfigurera och styra inbyggda byggverktyg för sina plattformar som stöds, till exempel MSBuild och Make. Mer information om CMake finns i CMake-dokumentationen.

NMAKE
Använd NMAKE (nmake.exe) för att skapa C++-projekt med hjälp av en traditionell makefile.

Anmärkning

Från och med Visual Studio 2019 version 16.5 använder MSBuild och DEVENV inte kommandoradsmiljön för att styra de verktyg och bibliotek som används.

I det här avsnittet

De här artiklarna visar hur du skapar appar på kommandoraden och beskriver hur du anpassar kommandoradsmiljön. Vissa visar hur du använder 64-bitars verktygssatser för att rikta in x86-, x64-, ARM- och ARM64-plattformar. De beskriver också användningen av kommandoradsverktygen MSBuild och NMAKE.

Genomgång: Kompilera ett internt C++-program på kommandoraden
Ger ett exempel som visar hur du skapar och kompilerar ett C++-program på kommandoraden.

Genomgång: Kompilera ett C-program på kommandoraden
Beskriver hur du kompilerar ett program skrivet på programmeringsspråket C.

Genomgång: Kompilera ett C++/CLI-program på kommandoraden
Beskriver hur du skapar och kompilerar ett C++/CLI-program som använder .NET Framework.

Genomgång: Kompilera ett C++/CX-program på kommandoraden
Beskriver hur du skapar och kompilerar ett C++/CX-program som använder Windows Runtime.

NMAKE-referens
Innehåller länkar till artiklar som beskriver underhållsverktyget för Microsoft Program (NMAKE.EXE).

MSBuild på kommandoraden – C++
Innehåller länkar till artiklar som beskriver hur du använder msbuild.exe från kommandoraden.

Relaterade avsnitt

/MD, /MT, /LD (Använd körbiblioteket)
Beskriver hur du använder de här kompilatoralternativen för att använda ett felsöknings- eller versionskörningsbibliotek.

C/C++-kompilatoralternativ
Innehåller länkar till artiklar som beskriver kompilatoralternativen C och C++ och CL.exe.

MSVC-länkalternativ
Innehåller länkar till artiklar som beskriver länkalternativen och LINK.exe.

Ytterligare MSVC-byggverktyg
Innehåller länkar till C/C++-byggverktygen som ingår i Visual Studio.

Se även

Projekt och byggsystem