A Microsoft C++ buildelési eszközeinek használata a parancssorból

C és C++ alkalmazásokat készíthet a parancssorban a Visual Studióban található eszközökkel. A Microsoft C++ (MSVC) buildelési eszközei önálló csomagként is letölthetők. Nem kell telepítenie a Visual Studio IDE-t, ha nem tervezi használni.

Megjegyzés:

Ez a cikk arról szól, hogyan állíthat be környezetet az egyes fordítók, linkerek, könyvtárosok és egyéb alapvető eszközök használatára. Az MSBuilden alapuló natív projektépítési rendszer a Visual Studióban nem használja a jelen cikkben ismertetett környezetet. Az MSBuild parancssorból való használatával kapcsolatos további információkért lásd : MSBuild a parancssorban – C++.

Az eszközök letöltése és telepítése

Ha telepítette a Visual Studiót és egy C++ számítási feladatot, az összes parancssori eszközzel rendelkezik. A C++ és a Visual Studio telepítéséről további információt a C++ telepítése a Visual Studióban című témakörben talál. Ha csak a parancssori eszközkészletet szeretné használni, töltse le a Visual Studióhoz készült Build Tools eszközt. A letöltött végrehajtható fájl futtatásakor a rendszer frissíti és futtatja a Visual Studio Installert. Ha csak a C++ fejlesztéshez szükséges eszközöket szeretné telepíteni, válassza ki a C++ számítási feladattal rendelkező asztali fejlesztést . A telepítés részletei között választható kódtárakat és eszközkészleteket is választhat. Ha a Visual Studio 2015, 2017 vagy 2019 eszközkészletek használatával szeretne kódot készíteni, válassza ki az opcionális MSVC v140, v141 vagy v142 buildelési eszközöket. Ha elégedett a kijelölésekkel, válassza a Telepítés lehetőséget.

A parancssori eszközök használata

Ha kiválasztja a C++ számítási feladatok egyikét a Visual Studio Installerben, alapértelmezés szerint az MSVC Build Tools csomag egy adott verzióját telepíti. A Visual Studio 2022-es és korábbi verzióiban ez egy platformeszközkészlet (v### verzióformátum) szerint van rendszerezve, amely a Visual Studio egy adott verziójához tartozó összes C és C++ eszközzel rendelkezik. A Visual Studio 2026-os és újabb verziói esetében ez az MSVC-verzióból (v##.## verzióformátumból) áll, amely az adott MSVC-csomag összes C és C++ eszközével rendelkezik. Az MSVC-verzió leválasztva van a Visual Studio verziójáról. Az eszközök közé tartoznak a C/C++ fordítók, a csatolók, az összeszerelők és az egyéb buildeszközök, valamint a megfelelő kódtárak és fejlécfájlok. Ezeket az eszközöket a parancssorban használhatja. Ezeket a Visual Studio IDE belsőleg is használja. Léteznek külön x86-os és x64-alapú fordítók és eszközök, amelyek az x86- , x64-, ARM- és ARM64-célok kódját készítik. Az egyes specifikus gazdagép és célarchitektúra eszközkészletei a saját könyvtáraikban vannak tárolva.

A megfelelő működéshez az eszközöknek több konkrét környezeti változót kell beállítaniuk. Ezek a változók az eszközök elérési úthoz való hozzáadására és a fájlok, tárfájlok és SDK-k helyének beállítására szolgálnak. A környezeti változók egyszerű beállítása érdekében a telepítő testre szabott parancsfájlokat vagy kötegelt fájlokat hoz létre a telepítés során. Ezen parancsfájlok egyikét futtatva beállíthat egy adott gazdagép- és célarchitektúrát, Windows SDK-verziót és platformeszközöket. A kényelem érdekében a telepítő parancsikonokat is létrehoz a Start menüben. A parancsikonok megnyitják a fejlesztői parancssori ablakokat a gazdagép és a cél adott kombinációinak parancsfájljaival. Ezek a billentyűparancsok biztosítják, hogy az összes szükséges környezeti változó be legyen állítva és használatra kész legyen.

A szükséges környezeti változók a telepítésre és a választott buildarchitektúrára vonatkoznak. A termékfrissítések vagy a frissítések is módosíthatják őket. Ez a variabilitás az egyik oka annak, hogy a környezeti változók beállítása helyett a telepített parancssori parancsikont vagy parancsfájlt javasoljuk.

A telepített eszközkészletek, parancsfájlok és parancsikonok a számítógép processzorától és a telepítés során kiválasztott beállításoktól függnek. Az x86-os és x64-kódot készítő x86-ra telepített és keresztfejlesztő eszközök mindig telepítve vannak. Ha 64 bites Windowst használ, az x64-alapú eszközök és az x86- és x64-kódot buildelő kereszteszközök is telepítve lesznek. Ha az opcionális C++ univerzális Windows platformeszközöket választja, akkor az ARM- és ARM64-kódot buildelő x86- és x64-eszközök is települnek. Más számítási feladatok is telepíthetik ezeket és más eszközöket.

Elérési út és környezeti változók parancssori buildekhez

Az MSVC parancssori eszközei a PATH, TMP, INCLUDE, LIBés LIBPATH környezeti változókat használják, valamint a telepített eszközökre, platformokra és SDK-kra jellemző egyéb környezeti változókat is. Akár egy egyszerű Visual Studio-telepítés is beállíthat húsz vagy több környezeti változót. Ez a bonyolultság az oka annak, hogy határozottan javasoljuk, hogy használjon fejlesztői parancssori parancsikont vagy a testre szabott parancsfájlok egyikét. Nem javasoljuk, hogy ezeket a változókat saját maga állítsa be a Windows-környezetben.

Ha látni szeretné, hogy a fejlesztői parancssor parancsikonja mely környezeti változókat állítja be, használhatja a SET parancsot. Nyisson meg egy egyszerű parancssori ablakot, és rögzítse az SET alapterv parancsának kimenetét. Nyisson meg egy fejlesztői parancssori ablakot, és rögzítse a SET parancs kimenetét összehasonlítás céljából. Használja a Visual Studióba beépített diff eszközt a fejlesztői parancssor által beállított környezeti változók kiemeléséhez. A fordító és a linker környezeti változóiról további információt a CL környezeti változókban talál.

Fejlesztői parancssori parancsikonok

A parancssori parancsikonok a Windows Start menü egy verzióspecifikus Visual Studio-mappájába vannak telepítve. Az alábbi lista tartalmazza az alapszintű parancssori parancsikonokat és az általuk támogatott buildarchitektúrákat:

• Fejlesztői parancssor – Beállítja a környezetet, hogy 32 bites, x86 natív eszközöket használjon a 32 bites, x86-natív kód létrehozásához.
• x86 Natív eszközök parancssora – Beállítja a környezetet, hogy 32 bites, x86-natív eszközöket használjon a 32 bites, x86-natív kód létrehozásához.
• x64 Natív eszközök parancssora – Beállítja a környezetet, hogy 64 bites, x64-natív eszközöket használjon a 64 bites, x64-natív kód létrehozásához.
• x86_x64 Eszközök közötti parancssor – Beállítja a környezetet, hogy 32 bites, x86-natív eszközöket használjon a 64 bites, x64-natív kód létrehozásához.
• x64_x86 Eszközök közötti parancssor – Beállítja a környezetet, hogy 64 bites, x64-natív eszközöket használjon a 32 bites, x86-natív kód létrehozásához.

A Start menü mappája és a parancsikonnevek a Visual Studio telepített verziójától függően változnak. Ha beállít egyet, az a telepítés becenevétől is függ. Tegyük fel például, hogy telepítette a Visual Studio 2022-t, és a Latest becenevet adta neki. A fejlesztői parancssor parancsikonját Developer Command Prompt for VS 2022 (Latest) névvel a Visual Studio 2022 nevű mappában találja.

Megjegyzés:

Számos parancssori eszköz vagy eszközbeállítás rendszergazdai engedélyt igényelhet. Ha engedélyproblémák merülnek fel a használatukkal kapcsolatban, javasoljuk, hogy a Futtatás rendszergazdaként lehetőséggel nyissa meg a fejlesztői parancssori ablakot. Kattintson a jobb gombbal a parancssori ablak helyi menüjének megnyitásához, majd válassza az Egyebek, Futtatás rendszergazdaként parancsot.

Fejlesztői parancssori ablak megnyitása

1. Nyissa meg az asztalon a Windows Start menüt. A Windows 11-ben a Minden alkalmazás gombra kattintva nyissa meg a telepített alkalmazások listáját. A Windows 10-ben a lista bal oldalon nyílik meg. Görgessen le a listáról, és nyissa meg a Visual Studio-verzióhoz tartozó mappát (nem az alkalmazást), például a Visual Studio 2022-et.

2. A mappában válassza a Visual Studio verziójához tartozó fejlesztői parancssort . Ez a parancsikon elindít egy fejlesztői parancssori ablakot, amely a 32 bites, x86 natív eszközök alapértelmezett buildarchitektúráját használja a 32 bites, x86-natív kód létrehozásához. Ha nem alapértelmezett buildarchitektúrát szeretne használni, válasszon egy natív vagy többeszközes parancssort a gazdagép és a célarchitektúra megadásához.

A fejlesztői parancssor még gyorsabb megnyitásához írja be a fejlesztői parancssort az asztali keresőmezőbe. Ezután válassza ki a kívánt eredményt.

Megjegyzés:

Alapértelmezés szerint a fejlesztői parancssor aktuális munkakönyvtára a Visual Studio Program Files könyvtárban való telepítésének gyökere. Ez nem megfelelő hely a kódhoz és a projektekhez. Projekt létrehozása előtt módosítsa az aktuális munkakönyvtárat egy másik helyre. Az IDE általában a felhasználói címtárban hoz létre projekteket %USERPROFILE%\source\repos.

Fejlesztői parancsfájl helyei

Ha a buildkörnyezetet egy meglévő parancssori ablakban szeretné beállítani, használhatja a telepítő által létrehozott parancsfájlok egyikét. Javasoljuk, hogy a környezetet egy új parancssori ablakban állítsa be. Nem javasoljuk, hogy később ugyanabban a parancsablakban váltson környezetekre.

A parancsfájl helye a telepített Visual Studio verziójától és a telepítés során hozott döntésektől függ. A Visual Studio 2022 esetében a 64 bites rendszerek tipikus telepítési helye a \Program Files\Microsoft Visual Studio\2022\<edition>. Lehet <edition> a Community, Professional, Enterprise, BuildTools vagy bármelyik más becenév, amit önmaga megadott.

Az elsődleges fejlesztői parancssor parancssori fájlja VsDevCmd.bataz Common7\Tools alkönyvtárban található. Ha nincsenek megadva paraméterek, a környezet úgy állítja be a környezetet, hogy az x86-natív eszközöket használja a 32 bites x86-kód létrehozásához.

További parancsfájlok érhetők el adott buildarchitektúrák beállításához. Az elérhető parancsfájlok a Telepített Visual Studio számítási feladataitól és beállításaitól függenek. A Visual Studio 2017-ben és a Visual Studio 2019-ben az VC\Auxiliary\Build alkönyvtárban találja őket.

Ezek a parancsfájlok beállítják az alapértelmezett paramétereket, és meghívják VsDevCmd.bat a megadott buildarchitektúra-környezet beállítását. Egy tipikus telepítés a következő parancsfájlokat tartalmazhatja:

Parancsfájl	Kiszolgáló- és célarchitektúrák
vcvars32.bat	A 32 bites x86-os natív eszközökkel 32 bites x86-kódot készíthet.
vcvars64.bat	A 64 bites x64-natív eszközökkel 64 bites x64-kódot készíthet.
vcvarsx86_amd64.bat	A 32 bites x86-natív kereszteszközökkel 64 bites x64-kódot készíthet.
vcvarsamd64_x86.bat	A 64 bites x64-natív kereszteszközökkel 32 bites x86-kódot készíthet.
vcvarsx86_arm.bat	Arm-kód létrehozásához használja a 32 bites x86-natív kereszteszközöket.
vcvarsamd64_arm.bat	Az ARM-kód létrehozásához használja a 64 bites x64-natív kereszteszközöket.
vcvarsx86_arm64.bat	Arm64-kód létrehozásához használja a 32 bites x86-natív kereszteszközöket.
vcvarsamd64_arm64.bat	Arm64-kód létrehozásához használja a 64 bites x64-natív kereszteszközöket.
vcvarsall.bat	Paraméterekkel adhatja meg a gazdagép- és célarchitektúrákat, a Windows SDK-t és a platformlehetőségeket. A támogatott lehetőségek listájának megtekintéséhez használja a /help paramétert híváskor.

Figyelmeztetés

A vcvarsall.bat fájl és más Visual Studio-parancsfájlok számítógépről számítógépre változhatnak. Ne cserélje le a hiányzó vagy sérült vcvarsall.bat fájlokat egy másik számítógépről származó fájl használatával. Futtassa újra a Visual Studio telepítőt a hiányzó fájl cseréjéhez.

A vcvarsall.bat fájl verzióról verzióra is változik. Ha a Visual Studio jelenlegi verziója olyan számítógépre van telepítve, amely a Visual Studio korábbi verzióját is tartalmazza, ne futtassa vcvarsall.bat vagy más Visual Studio verziókból származó parancsfájlt ugyanabban a parancssori ablakban.

A fejlesztői eszközök használata egy meglévő parancsablakban

Egy meglévő parancsablakban egy adott buildarchitektúra megadásának legegyszerűbb módja a vcvarsall.bat fájl használata. Környezeti vcvarsall.bat változók beállításával konfigurálhatja a parancssort natív 32 bites vagy 64 bites fordításhoz. Az argumentumokkal keresztfordítást határozhat meg x86, x64, ARM vagy ARM64 processzorarchitektúrákra. Megcélzhatja a Microsoft Store-t, az univerzális Windows platformot vagy a Windows Desktop platformot. Megadhatja, hogy melyik Windows SDK-t használja, és válassza ki a platformeszközök verzióját.

Ha argumentumok nélkül használja, a környezeti változókat úgy konfigurálja, vcvarsall.bat hogy az aktuális x86-natív fordítót használja a 32 bites Windows Desktop-célokhoz. Argumentumokkal konfigurálhatja a környezetet úgy, hogy bármely natív vagy keresztfordító eszközt használjon. vcvarsall.bat hibaüzenet jelenik meg, ha olyan konfigurációt ad meg, amely nincs telepítve, vagy nem érhető el a számítógépen.

vcvarsall szintaxis

vcvarsall.bat[architecture] [platform_typewinsdk_version] [-vcvars_ver=vcversion] [] [spectre_mode]

architecture
Ez az opcionális argumentum határozza meg a használni kívánt hoszt- és célarchitektúrát. Ha architecture nincs megadva, a rendszer az alapértelmezett buildkörnyezetet használja. Ezek az argumentumok támogatottak:

architecture	Fordítóprogram	Gazdagép architektúrája	Kimeneti (cél)architektúra létrehozása
x86	x86 32 bites natív	x86, x64	x86
x86_amd64 vagy x86_x64	x64 x86 kereszten	x86, x64	x64
x86_arm	ARM x86 kereszt-kompatibilitás	x86, x64	ARM
x86_arm64	ARM64 x86 keresztplatformon	x86, x64	ARM64
amd64 vagy x64	natív x64 64 bites	x64	x64
amd64_x86 vagy x64_x86	x86 és x64 közötti átjárhatóság	x64	x86
amd64_arm vagy x64_arm	ARM x64 kereszt-platformon	x64	ARM
amd64_arm64 vagy x64_arm64	ARM64 x64 kereszten	x64	ARM64

platform_type
Ez az opcionális argumentum lehetővé teszi a platformtípus megadását store vagy uwp típusát. Alapértelmezés szerint a környezet asztali vagy konzolalkalmazások készítésére van beállítva.

winsdk_version
Opcionálisan megadja a használni kívánt Windows SDK-verziót. Alapértelmezés szerint a rendszer a legújabb telepített Windows SDK-t használja. A Windows SDK-verzió megadásához használhat teljes Windows SDK-számot, például 10.0.10240.0, vagy megadhatja 8.1 a Windows 8.1 SDK használatát.

vcversion
Opcionálisan megadja a használni kívánt Visual Studio fordítóeszközkészletet. Alapértelmezés szerint a környezet az aktuális Visual Studio fordítóeszközkészlet használatára van beállítva.

A -vcvars_ver=14.2x.yyyy használatával adja meg a Visual Studio 2019 fordítóeszközkészlet egy adott verzióját.

A -vcvars_ver=14.29 használatával adja meg a Visual Studio 2019 fordítóeszközkészlet legújabb verzióját.

A -vcvars_ver=14.0 használatával adja meg a Visual Studio 2015 fordítóeszközkészletét.

spectre_mode
Hagyja ki ezt a paramétert a könyvtárak használatához Spectre enyhítések nélkül. Az spectre érték használata a Spectre-kockázatcsökkentésekkel ellátott könyvtárak használatát teszi lehetővé.

A buildkörnyezet beállítása egy meglévő parancssori ablakban

1. A parancssorban a CD paranccsal váltson a Visual Studio telepítési könyvtárára. Ezután használja ismét a CD-t, hogy átváltson a konfigurációspecifikus parancsfájlokat tartalmazó alkönyvtárra. A Visual Studio 2019 és a Visual Studio 2017 esetében használja az VC\Auxiliary\Build alkönyvtárat. Visual Studio 2015 esetén használja az VC alkönyvtárat.

2. Adja meg az előnyben részesített fejlesztői környezet parancsát. Ha például egy 64 bites platformon szeretné létrehozni az UWP-hez készült ARM-kódot a Legújabb Windows SDK és Visual Studio fordítóeszközkészlet használatával, használja ezt a parancssort:

   vcvarsall.bat amd64_arm uwp
   

Saját parancssori parancsikon létrehozása

Nyissa meg a fejlesztői parancssori parancsikon Tulajdonságok párbeszédpaneljét a használt parancscél megtekintéséhez. A VS 2019-hez készült x64 natív eszközök parancssorának célja például a következőhöz hasonló:

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

Az architektúraspecifikus kötegfájlok beállítják a(z) architecture paramétert, és hívják a(z) vcvarsall.bat. Ugyanazokat a beállításokat adhatja át ezeknek a kötegfájloknak, mint amelyeket a vcvarsall.bat-nak adna át, vagy egyszerűen közvetlenül is hívhatja a vcvarsall.bat-t. A parancsikon paramétereinek megadásához adja hozzá őket a parancs végéhez dupla idézőjelekben. Íme például egy parancsikon, a 64 bites platformon, a legújabb Windows SDK használatával az UWP-hez készült ARM-kód létrehozásához. Egy korábbi fordítóeszközkészlet használatához adja meg a verziószámot. A parancsikonban ehhez hasonló parancscélt használhat:

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

Módosítsa az elérési utat a Visual Studio telepítési könyvtárának megfelelően. A vcvarsall.bat fájl további információkat tartalmaz a megadott verziószámokról.

Parancssori eszközök

A C/C++ projekt parancssorban való létrehozásához a Visual Studio a következő parancssori eszközöket biztosítja:

CL
A fordítóval (cl.exe) forráskódfájlokat fordíthat le és csatolhat alkalmazásokhoz, kódtárakhoz és DLL-ekhez.

Link
Használja a linker (link.exe) a lefordított objektumfájlok és tárak alkalmazásokhoz és DLL-ekhez való linkelésére.

Ha a parancssorra épít, az F1 parancs nem érhető el azonnali segítségért. Ehelyett egy keresőmotor használatával információkat kaphat a figyelmeztetésekről, hibákról és üzenetekről. Az offline súgófájlokat is letöltheti és használhatja. Ha a Microsoft Learnben szeretné használni a keresést, írja be a lekérdezést a cikk tetején található keresőmezőbe.

Parancssori projektfelügyeleti eszközök

A Visual Studio IDE alapértelmezés szerint az MSBuilden alapuló natív projektépítési rendszereket használ. Az MSBuild meghívásával közvetlenül hozhat létre projekteket az IDE használata nélkül. Ön is használhatja a devenv parancsot, hogy a Visual Studio-val projekteket és megoldásokat építsen. A Visual Studio cMake vagy NMake alapú buildelési rendszereket is támogat.

MSBuild
Az MSBuild (msbuild.exe) és a projektfájl (.vcxproj) használatával konfigurálhat egy buildet, és meghívhatja az eszközkészletet a Visual Studio IDE betöltése nélkül. Ez egyenértékű a Build project vagy a Build Solution paranccsal a Visual Studio IDE-ben. Az MSBuild előnye az IDE-hez képest, ha a parancssorban épít. Nem kell telepítenie a teljes IDE-t az összes buildkiszolgálóra és buildelési folyamatra. Elkerülheti az IDE többletterhelését. Az MSBuild tárolóalapú buildkörnyezetekben fut, és támogatja a bináris naplózókat.

DEVENV
A DEVENV (devenv.exe) használata parancssori kapcsolóval kombinálva, például /Build/Clean egyes buildparancsok végrehajtásához a Visual Studio IDE megjelenítése nélkül.

CMake
A CMake (cmake.exe) egy platformfüggetlen, nyílt forráskódú eszköz a több platformon futó buildfolyamatok meghatározásához. A CMake konfigurálhatja és vezérelheti a natív buildelési eszközöket a támogatott platformokhoz, például az MSBuildhez és a Make-hez. További információt a CMake-ről a CMake dokumentációjábantalál.

NMAKE
Az NMAKE (nmake.exe) használatával C++ projekteket hozhat létre hagyományos makefile használatával.

Megjegyzés:

A Visual Studio 2019 16.5-ös verziójától kezdve az MSBuild és a DEVENV nem használja a parancssori környezetet a használt eszközkészletek és kódtárak vezérlésére.

Ebben a szakaszban

Ezek a cikkek bemutatják, hogyan hozhat létre alkalmazásokat a parancssorban, és hogyan szabhatja testre a parancssori buildkörnyezetet. Némelyik bemutatja, hogyan használhat 64 bites eszközkészleteket, és hogyan célozhatja meg az x86-os, x64-, ARM- és ARM64-platformokat. Emellett az MSBuild és az NMAKE parancssori buildelési eszközök használatát is ismertetik.

Útmutató: Natív C++ program összeállítása a parancssorban
Egy példa bemutatja, hogyan hozhat létre és fordíthat le C++ programot a parancssorban.

Útmutató: C-program fordítása a parancssorban
A C programozási nyelven írt programok fordítását ismerteti.

Útmutató: C++/CLI-program összeállítása a parancssorban
A .NET-keretrendszert használó C++/CLI-program létrehozását és fordítását ismerteti.

Útmutató: C++/CX program összeállítása a parancssorban
Ismerteti, hogyan hozhat létre és fordíthat le windowsos futtatókörnyezetet használó C++/CX-programokat.

NMAKE-referencia
A Microsoft Program Maintenance Utility (NMAKE.EXE) programot ismertető cikkekre mutató hivatkozásokat tartalmaz.

MSBuild a parancssorban – C++
A parancssorból történő használatról msbuild.exe szóló cikkekre mutató hivatkozásokat tartalmaz.

Kapcsolódó szakaszok

/MD, /MT, /LD (Futásidejű kódtár használata)
Ismerteti, hogyan használhatja ezeket a fordítóbeállításokat hibakeresési vagy kiadási futásidejű kódtárak használatára.

C/C++ fordító beállításai
Olyan cikkekre mutató hivatkozásokat tartalmaz, amelyek tárgyalják a C és a C++ fordító beállításait és CL.exe.

MSVC-csatoló beállításai
Olyan cikkekre mutató hivatkozásokat tartalmaz, amelyek a linker opciókat és a LINK.exe-t tárgyalják.

További MSVC buildelési eszközök
A Visual Studióban található C/C++ buildelési eszközökre mutató hivatkozásokat tartalmaz.

Lásd még

Projektek és rendszerek létrehozása