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) buildeszközöket önálló csomagként is letöltheti. 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, csatolók, kódtárak é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 Visual Studio és egy C++ számítási feladatot, az összes parancssori eszközzel rendelkezik. 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 Tols for Visual Studio elemet a Build Tools letöltésének megkereséséhez. 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 területen kiválaszthatja az opcionális kódtárakat és eszközkészleteket. Ha a 2015-ös Visual Studio, a 2017-Visual Studio vagy a 2019-Visual Studio 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 telepíti az MSVC Build Tools csomag egy adott verzióját. A 2022-es és korábbi Visual Studio csomag egy platform-eszközkészlet (v### verzióformátum) szerint van rendszerezve, amely tartalmazza a Visual Studio adott verziójához tartozó összes C és C++ eszközt. A 2026-os Visual Studio kezdve az MSVC-verzió leválasztva van a Visual Studio verzióról. Más szóval a 2026-os Visual Studio-tól kezdve a csomag megfelel az MSVC eszközkészlet verziójának (v##.## verzióformátum), amely tartalmazza az adott MSVC Build Tools csomag összes C és C++ eszközét.

Az eszközök közé tartoznak a C/C++ fordítók, a csatolók, az összeszerelők és az egyéb buildelési eszközök. Egyező kódtárakat és fejlécfájlokat tartalmaz. Ezeket az eszközöket a parancssorban használhatja. A Visual Studio IDE belsőleg használja ő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.

Az eszközökhöz több környezeti változót is be kell állítani. Ezek a változók hozzáadják az eszközöket az elérési úthoz, és beállítják a fájlok, tárfájlok és SDK-k helyét. 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 a gazda- és célarchitektúrák meghatározott kombinációihoz tartozó parancsfájlok használatával nyitják meg a fejlesztői Parancssor ablakokat. 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 -frissítések megváltoztathatják a változókat. 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ítő által hozzáadott 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, az ARM- és ARM64-kódot tartalmazó x86- és x64-eszközök is telepítve lesznek. Más számítási feladatok is telepíthetik ezeket az 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. A telepített eszközökre, platformokra és SDK-kra vonatkozó egyéb környezeti változókat is használnak. Még 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 meg szeretné tekinteni, hogy a fejlesztői parancssor parancsikonjai mely környezeti változókat használják, használja 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 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-os eszközöket használjon a 32 bites x86-kód létrehozásához.
• x86 Natív eszközök parancssora. Beállítja a környezetet, hogy 32 bites x86-os eszközöket használjon a 32 bites x86-kód létrehozásához.
• x64 Natív eszközök parancssora. Beállítja a környezetet, hogy 64 bites x64-eszközöket használjon a 64 bites x64-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-eszközöket használjon a 64 bites x64-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-eszközöket használjon a 32 bites x86-kód létrehozásához.

A Start menümappája és parancsikonnevei a Visual Studio telepített verziójától függően változnak. Például a Visual Studio 2022 fejlesztői parancssorának parancsikonja Fejlesztői parancssor a VS 2022-höz néven szerepel a(z) Start>Programok>Visual Studio 2022>Visual Studio Tools alatt.

Megjegyzés:

Számos parancssori eszköz vagy eszközbeállítás rendszergazdai jogosultságot igényel. Ha a használatukkal kapcsolatban engedélyproblémák merülnek fel, javasoljuk, hogy a Futtatás rendszergazdaként lehetőséggel nyissa meg a fejlesztői parancssor ablakát. Kattintson a jobb gombbal a parancssori ablak helyi menüjének megnyitásához, majd válassza a További>futtatás rendszergazdaként lehetőséget.

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 lehetőséget a telepített alkalmazások listájának megnyitásához. A Windows 10 a lista bal oldalon van megnyitva. Görgessen lefelé a listában, és keresse meg és nyissa meg a Visual Studio verziójához tartozó mappát (nem az alkalmazást), például a < 2022>Visual Studio vagy Visual Studio 2026-os vagy újabb verzióhoz.
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 beállítja a környezetet, hogy 32 bites x86-os eszközöket használjon a 32 bites x86-kód létrehozásához. Ha nem az alapértelmezett buildarchitektúrát szeretné használni, válassza a natív vagy keresztfordítási eszközök valamelyik parancssorát a gazda- és 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 a hely nem felel meg a kódnak és a projekteknek. 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 telepítés tipikus helye C:\Program Files\Microsoft Visual Studio\2022\<edition>. A <edition> lehet Community, Professional, Enterprise, BuildTools.

Az elsődleges fejlesztői parancssori parancssori fájl VsDevCmd.bata Common7\Tools könyvtárban található. Ha nem ad meg paramétereket, úgy állítja be a környezetet, hogy az a 32 bites x86-kód fordításához a natív x86-es eszközöket használja.

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. 2017 Visual Studio és 2019 Visual Studio a VC\Auxiliary\Build kö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 egy 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 parancssori ablakot 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.

Ha argumentumok nélküli vcvarsall.bat használ, 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. Adjon hozzá argumentumokat a környezet konfigurálásához bármely natív vagy keresztfordító eszköz használatára. 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 nem adja meg architecture, a rendszer az alapértelmezett buildkörnyezetet használja. A következő 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 adja meg store vagy uwp a platform típusaként. 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áljon teljes Windows SDK-számot, például 10.0.10240.0, vagy adja meg a 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 a legújabb telepített Visual Studio fordítóeszközkészletet használja. Az alábbi táblázat példaértékeket vcvars_ver mutat be:

  vcvars_ver={value}	Result	VS 2026 példa	VS 2022 példa	VS 2019 példa	VS 2017 példa
  "Preview"	Használja az Visual Studio előzetes verziójú fordítóeszközkészletet.	Supported	Nem támogatott	Nem támogatott	Nem támogatott
  "14.0"	Használja a Visual Studio 2015-ös fordítóeszközkészletet.	Supported	Supported	Supported	Supported
  "14.xx"	Használja a legújabb telepített 14.xx.yyyyy eszközkészletet.	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Használjon egy adott teljes verziószámot.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Hagyja ki ezt a paramétert a könyvtárak használatához Spectre enyhítések nélkül. Adja meg a(z) spectre elemet, hogy a könyvtárakat Spectre elleni védelmekkel használja.

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

1. A parancssorban a CD paranccsal váltson a Visual Studio telepítési könyvtárra. Például C:\Program Files\Microsoft Visual Studio\18\Professional, ha a Visual Studio 2026-ot használja. 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 2017-hez és az újabb verziókhoz 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 szeretne ARM-kódot készíteni az UWP-hez, használja a legújabb Windows SDK-t és Visual Studio fordítóeszközkészletet, használja a következő parancsot:

   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 2022 fejlesztői parancssorának célja például a következőhöz hasonló:

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\Tools\VsDevCmd.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 a vcvarsall.bat elemnek, vagy közvetlenül is meghívhatja a vcvarsall.bat elemet. A saját parancsikon paramétereinek megadásához adja hozzá őket a parancs végéhez dupla idézőjelekkel. Egy korábbi fordítóeszközkészlet használatához adja meg a verziószámot.

Az ARM64-et csak a 2026-os Visual Studio kezdve célozhatja meg, mert az ARM32-célzás ekkor el lett távolítva.

Az alábbiakban egy parancsikont talál az UWP ARM64-kódjának 64 bites platformon való létrehozásához a legújabb Windows SDK használatával. Az ARM64 célzása a Visual Studio 2026-os és újabb verzióiban jelenik meg. Az ARM32 célzása a korábbi verziók esetében jelenik meg.

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

Á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, 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 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.

Lásd még

• Útmutató: Natív C++ program összeállítása a parancssorban
• Útmutató: C-program fordítása a parancssorban
• Útmutató: C++/CLI-program összeállítása a parancssorban
• Útmutató: C++/CX program összeállítása a parancssorban
• Projektek és rendszerek létrehozása
• /MD, /MT, /LD (Futásidejű kódtár használata)
• C/C++ fordító beállításai
• MSVC-csatoló beállításai
• További MSVC buildelési eszközök