A Microsoft C++ parancssori eszközkészletének használata

C és C++ alkalmazásokat készíthet a parancssorban a Visual Studióban található eszközökkel. A Microsoft C++ (MSVC) fordítóeszközkészlet önálló csomagként is letölthető. 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

Amikor kiválasztja a C++ számítási feladatok egyikét a Visual Studio Installerben, az telepíti a Visual Studio platformeszközkészletét. Egy platformeszközkészlet tartalmazza az összes C és C++ eszközt egy adott Visual Studio-verzióhoz. 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. Külön x86-alapú és x64-alapú fordítók és eszközök léteznek az x86, x64, ARM és ARM64 célok kódjának összeállítására. 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 a felhasználói könyvtárában hoz létre projekteket, általában a %USERPROFILE%\source\reposzban.

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 2019 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 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é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 nincs megadva architektúra , 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	KAR
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	KAR
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 a CD használatával váltson ismét 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. Visual Studio 2015 esetén 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 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 adott 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óprogrammal (cl.exe) lefordíthatja és összefűzheti a forráskódfájlokat alkalmazásokba, kódtárakba és DLL-ekbe.

Link
A linker (link.exe) használatával lefordított objektumfájlokat és tárakat csatolhat alkalmazásokhoz és DLL-ekhez.

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
Használja a DEVENV-t (devenv.exe) egy parancssori kapcsolóval, mint például a /Build vagy a /Clean, hogy bizonyos build parancsokat hajtson 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, amely több platformon futó buildfolyamatokat definiál. 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 programkarbantartási segédprogramot (NMAKE.EXE) ismertető cikkekre mutató hivatkozásokat tartalmaz.

MSBuild a parancssorban – C++
A parancssorból származó msbuild.exe használatát bemutató 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
A C és C++ fordító beállításait és CL.exeismertető cikkekre mutató hivatkozásokat tartalmaz.

MSVC-csatoló beállításai
Olyan cikkekre mutató hivatkozásokat tartalmaz, amelyek a hivatkozási lehetőségeket és a LINK.exeismertetik.

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