A parancssorból történő Microsoft C++ buildeszközök használata

A parancssorban C és C++ alkalmazásokat hozhat létre a Visual Studio részét képező eszközökkel. A Microsoft C++ (MSVC) buildelési eszközök önálló csomagként is letölthetők. Nem kell telepítenie a Visual Studio IDE, 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. A Visual Studio msBuild alapú natív projektépítési rendszere 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 Studio-t és a C++ munkaterhelést, rendelkezik az összes parancssori eszközzel. C++ és a Visual Studio telepítéséről a következő helyen talál információt: C++ támogatás telepítése a Visual Studio-ban. Ha csak a parancssori eszközkészletet szeretné használni, töltse le a Build Tools for Visual Studio. A Letöltések lapon bontsa ki a Visual Studio eszközei szakaszt, hogy megtalálja a Build eszközök letöltését. A letöltött végrehajtható fájl futtatásakor a rendszer frissíti és futtatja a Visual Studio Telepítőt. 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 2015-ös, 2017-ös vagy 2019-Visual Studio eszközökkel szeretne kódot készíteni, válassza ki az opcionális MSVC v140, v141 vagy v142 buildeszkö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 a Visual Studio Telepítőben kiválaszt egy C++ számítási feladatot, alapértelmezés szerint az MSVC Build Tools csomag egy adott verzióját telepíti. A 2022-es és korábbi Visual Studio esetében ez egy platform-eszközkészlet (v### verzióformátum), amely a Visual Studio adott verziójához tartozó összes C és C++ eszközzel rendelkezik. A 2026-os és újabb Visual Studio 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ó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. A Visual Studio IDE belsőleg is használják őket. 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él buildarchitektú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 Windows rendelkezik, az x64 által üzemeltetett 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-platform eszkö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. A fejlesztői parancssor által beállított környezeti változók kiemeléséhez használjon olyan diff eszközt, mint a Visual Studio beépített eszköz. 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 egy verzióspecifikus Visual Studio mappába vannak telepítve a Windows Start menüben. 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 parancsikonok neve a Visual Studio telepített verziójától függően változik. Ha beállít egyet, az a telepítés becenevétől is függ. Tegyük fel például, hogy a 2022-Visual Studio telepítette, és Latest becenevet adott neki. A fejlesztői parancssori parancsikon neve Developer parancssor a VS 2022 (legújabb) fájlhoz, egy Visual Studio 2022 nevű mappában.

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. Az Windows 11 válassza a Az alkalmazások gombot a telepített alkalmazások listájának megnyitásához. A Windows 10 a lista bal oldalon van megnyitva. Görgessen le a listáról, és nyissa meg a mappát (nem az alkalmazást) a Visual Studio verziójához, például Visual Studio 2022.

2. A mappában válassza a Developer parancssort a Visual Studio verziójához. 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 az 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 2022-Visual Studio esetében a 64 bites rendszerek tipikus telepítési helye \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 feladatoktól és beállításoktól függnek. A Visual Studio 2017-ben és a Visual Studio 2019-ben a 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éterek használatával adja meg a gazdagép- és célarchitektúrákat, a Windows SDK-t és a platformopciókat. 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, amelyen az Visual Studio korábbi verziója is található, ne futtassa vcvarsall.bat vagy más Visual Studio parancsfájlt ugyanabban a parancssori ablakban található különböző verziókból.

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 Microsoft Store, Univerzális Windows-platform vagy Windows asztali platformokat. Megadhatja, hogy melyik Windows SDK-t használja, és válassza ki a platformeszközök verzióját.

Argumentumok nélkül használva a vcvarsall.bat a környezeti változókat úgy konfigurálja, hogy az aktuális x86-natív fordítót használja a 32 bites Windows asztali 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óját. Alapértelmezés szerint a legújabb telepített Windows SDK van használatban. 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ához.

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.yyyyyy használatával adja meg a Visual Studio 2019-es fordítóeszközkészlet egy adott verzióját.

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

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

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árra. 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 a VC\Auxiliary\Build alkönyvtárat. A Visual Studio 2015 esetében használja a 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, használja a legújabb Windows SDK-t és Visual Studio fordítóeszközkészletet, 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

Állítsa be 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

C/C++ projekt parancssorban való létrehozásához 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

Alapértelmezés szerint a Visual Studio IDE 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. A devenv paranccsal Visual Studio is létrehozhat projekteket és megoldásokat. Visual Studio CMake- vagy NMake-alapú buildelési rendszereket is támogat.

MSBuild
Az MSBuild (msbuild.exe) és egy 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. Egyenértékű a Build projekt vagy Build Solution parancs futtatásával a Visual Studio IDE. 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) parancssori kapcsolóval (például /Build vagy /Clean) kombinálva bizonyos buildparancsokat hajthat végre 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 2019. Visual Studio 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
A Windows-futtatókörnyezet használó C++/CX program létrehozását és fordítását ismerteti.

NMAKE-referencia
A Microsoft programkarbantartási segédprogramot (NMAKE.EXE) 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 Studio részét képező C/C++ buildelési eszközökre mutató hivatkozásokat tartalmaz.

Lásd még

Projektek és rendszerek létrehozása