Menggunakan toolset Microsoft C++ dari baris perintah

Anda dapat membangun aplikasi C dan C++ di baris perintah dengan menggunakan alat yang disertakan dalam Visual Studio. Toolset pengkompilasi Microsoft C++ (MSVC) juga dapat diunduh sebagai paket mandiri. Anda tidak perlu menginstal IDE Visual Studio jika Anda tidak berencana untuk menggunakannya.

Catatan

Artikel ini berisi tentang cara menyiapkan lingkungan untuk menggunakan pengkompilasi individu, linker, pustakawan, dan alat dasar lainnya. Sistem build proyek asli di Visual Studio, berdasarkan MSBuild, tidak menggunakan lingkungan seperti yang dijelaskan dalam artikel ini. Untuk informasi selengkapnya tentang cara menggunakan MSBuild dari baris perintah, lihat MSBuild pada baris perintah - C++.

Mengunduh dan menginstal alat

Jika Anda telah menginstal Visual Studio dan beban kerja C++, Anda memiliki semua alat baris perintah. Untuk informasi tentang cara menginstal C++ dan Visual Studio, lihat Menginstal dukungan C++ di Visual Studio. Jika Anda hanya menginginkan toolset baris perintah, unduh Build Tools for Visual Studio. Saat Anda menjalankan executable yang diunduh, ia memperbarui dan menjalankan Alat Penginstal Visual Studio. Untuk menginstal hanya alat yang Anda butuhkan untuk pengembangan C++, pilih pengembangan Desktop dengan beban kerja C+ +. Anda dapat memilih pustaka dan toolset opsional untuk disertakan di bawah Detail penginstalan. Untuk membuat kode dengan menggunakan toolset Visual Studio 2015, 2017, atau 2019, pilih alat build MSVC v140, v141, atau v142 opsional. Saat Anda puas dengan pilihan Anda, pilih Instal.

Cara menggunakan alat baris perintah

Saat Anda memilih salah satu beban kerja C++ di Alat Penginstal Visual Studio, ia menginstal toolset platform Visual Studio. Toolset platform memiliki semua alat C dan C++ untuk versi Visual Studio tertentu. Alat ini mencakup kompilator C/C++, linker, perakit, dan alat build lainnya, serta pustaka dan file header yang cocok. Anda dapat menggunakan semua alat ini di baris perintah. Mereka juga digunakan secara internal oleh Ide Visual Studio. Ada kompiler dan alat yang dihosting x86 dan x64 terpisah untuk membangun kode untuk target x86, x64, ARM, dan ARM64. Setiap set alat untuk arsitektur build host dan target tertentu disimpan di direktorinya sendiri.

Agar berfungsi dengan benar, alat memerlukan beberapa variabel lingkungan tertentu untuk diatur. Variabel ini digunakan untuk menambahkan alat ke jalur, dan untuk mengatur lokasi sertakan file, file pustaka, dan SDK. Untuk memudahkan untuk mengatur variabel lingkungan ini, alat penginstal membuat file perintah yang disesuaikan, atau file batch, selama penginstalan. Anda dapat menjalankan salah satu file perintah ini untuk mengatur arsitektur build host dan target tertentu, versi Windows SDK, dan toolset platform. Untuk kenyamanan, alat penginstal juga membuat pintasan di menu Mulai Anda. Pintasan membuka jendela prompt perintah pengembang dengan menggunakan file perintah ini untuk kombinasi host dan target tertentu. Pintasan ini memastikan semua variabel lingkungan yang diperlukan diatur dan siap digunakan.

Variabel lingkungan yang diperlukan khusus untuk penginstalan Anda dan arsitektur build yang Anda pilih. Mereka juga dapat diubah oleh pembaruan atau peningkatan produk. Varianbilitas ini adalah salah satu alasan mengapa kami menyarankan Anda menggunakan pintasan perintah atau file perintah yang diinstal, alih-alih mengatur variabel lingkungan sendiri.

Set alat, file perintah, dan pintasan yang diinstal bergantung pada prosesor komputer Anda dan opsi yang Anda pilih selama penginstalan. Alat yang dihosting x86 dan alat silang yang membangun kode x86 dan x64 selalu diinstal. Jika Anda memiliki Windows 64-bit, alat yang dihosting x64 dan alat silang yang membangun kode x86 dan x64 juga diinstal. Jika Anda memilih alat Platform Windows Universal C++ opsional, maka alat x86 dan x64 yang membangun kode ARM dan ARM64 juga diinstal. Beban kerja lain dapat menginstal ini dan alat lainnya.

Variabel jalur dan lingkungan untuk build baris perintah

Alat baris perintah MSVC menggunakan PATHvariabel lingkungan , , TMPINCLUDE, LIB, dan LIBPATH , dan juga menggunakan variabel lingkungan lain khusus untuk alat, platform, dan SDK yang diinstal. Bahkan penginstalan Visual Studio sederhana dapat mengatur dua puluh atau lebih variabel lingkungan. Kompleksitas inilah sebabnya kami sangat menyarankan Anda menggunakan pintasan perintah pengembang atau salah satu file perintah yang disesuaikan. Kami tidak menyarankan Anda mengatur variabel ini di lingkungan Windows sendiri.

Untuk melihat variabel lingkungan mana yang diatur oleh pintasan prompt perintah pengembang, Anda dapat menggunakan SET perintah . Buka jendela prompt perintah biasa dan ambil output SET perintah untuk garis besar. Buka jendela prompt perintah pengembang dan ambil output perintah untuk perbandingan SET . Gunakan alat diff seperti yang terpasang di Visual Studio untuk menyoroti variabel lingkungan yang ditetapkan oleh prompt perintah pengembang. Untuk informasi selengkapnya tentang variabel lingkungan pengkompilasi dan linker, lihat Variabel lingkungan CL.

Pintasan perintah pengembang

Pintasan perintah diinstal di folder Visual Studio khusus versi di Menu Mulai Windows Anda. Berikut adalah daftar pintasan prompt perintah dasar dan arsitektur build yang mereka dukung:

• Prompt Perintah Pengembang - Mengatur lingkungan untuk menggunakan alat asli x86 32-bit untuk membangun kode asli x86 32-bit.
• x86 Native Tools Command Prompt - Mengatur lingkungan untuk menggunakan alat x86-native 32-bit untuk membangun kode asli x86 32-bit.
• x64 Native Tools Command Prompt - Mengatur lingkungan untuk menggunakan alat asli x64-bit 64-bit untuk membangun kode asli x64-bit 64-bit.
• x86_x64 Cross Tools Command Prompt - Mengatur lingkungan untuk menggunakan alat asli x86 32-bit untuk membangun kode asli x64-bit 64-bit.
• x64_x86 Perintah Lintas Alat - Mengatur lingkungan untuk menggunakan alat asli x64-bit 64-bit untuk membangun kode asli x86 32-bit.

Folder menu Mulai dan nama pintasan bervariasi tergantung pada versi Visual Studio yang diinstal. Jika Anda mengaturnya, mereka juga bergantung pada penginstalan Nickname. Misalnya, Anda menginstal Visual Studio 2022, dan Anda memberinya julukan Terbaru. Pintasan perintah pengembang diberi nama Developer Command Prompt untuk VS 2022 (Terbaru), dalam folder bernama Visual Studio 2022.

Catatan

Beberapa alat baris perintah atau opsi alat mungkin memerlukan izin Administrator. Jika Anda memiliki masalah izin saat menggunakannya, kami sarankan Anda membuka jendela prompt perintah pengembang dengan menggunakan opsi Jalankan sebagai Administrator . Klik kanan untuk membuka menu pintasan untuk jendela prompt perintah, lalu pilih Lainnya, Jalankan sebagai administrator.

Untuk membuka jendela prompt perintah pengembang

1. Pada desktop, buka menu Mulai Windows. Di Windows 11, pilih tombol Semua aplikasi untuk membuka daftar aplikasi yang diinstal. Di Windows 10, daftar terbuka di sebelah kiri. Gulir ke bawah daftar untuk menemukan dan membuka folder (bukan aplikasi) untuk versi Visual Studio Anda, misalnya, Visual Studio 2022.

2. Di folder , pilih Perintah Pengembang untuk versi Visual Studio Anda. Pintasan ini memulai jendela prompt perintah pengembang yang menggunakan arsitektur build default alat 32-bit, x86-native untuk membangun kode asli x86 32-bit. Jika Anda lebih suka arsitektur build non-default, pilih salah satu perintah asli atau lintas alat untuk menentukan arsitektur host dan target.

Untuk cara yang lebih cepat untuk membuka prompt perintah pengembang, masukkan prompt perintah pengembang di kotak pencarian desktop. Lalu pilih hasil yang Anda inginkan.

Catatan

Secara default, direktori kerja saat ini dalam prompt perintah pengembang adalah akar penginstalan Visual Studio Anda di direktori File Program. Ini bukan lokasi yang sesuai untuk kode dan proyek Anda. Ubah direktori kerja saat ini ke lokasi lain sebelum Anda membuat proyek. IDE membuat proyek di direktori pengguna Anda, biasanya di %USERPROFILE%\source\repos.

Lokasi file perintah pengembang

Jika Anda lebih suka mengatur lingkungan build di jendela prompt perintah yang ada, Anda dapat menggunakan salah satu file perintah yang dibuat oleh penginstal. Sebaiknya atur lingkungan di jendela prompt perintah baru. Kami tidak menyarankan Anda beralih lingkungan nanti di jendela perintah yang sama.

Lokasi file perintah bergantung pada versi Visual Studio yang Anda instal, dan pada pilihan yang Anda buat selama penginstalan. Untuk Visual Studio 2019, lokasi penginstalan umum pada sistem 64-bit ada di \Program Files\Microsoft Visual Studio\2022\<edition>. <edition> Mungkin Komunitas, Profesional, Perusahaan, BuildTools, atau nama panggilan lain yang Anda berikan.

File perintah perintah pengembang utama, VsDevCmd.bat, terletak di subdirektori Common7\Tools . Ketika tidak ada parameter yang ditentukan, parameter mengatur lingkungan untuk menggunakan alat x86-native untuk membangun kode x86 32-bit.

Lebih banyak file perintah tersedia untuk menyiapkan arsitektur build tertentu. File perintah yang tersedia bergantung pada beban kerja Visual Studio dan opsi yang telah Anda instal. Di Visual Studio 2017 dan Visual Studio 2019, Anda akan menemukannya di subdirektori VC\Auxiliary\Build.

File perintah ini mengatur parameter default dan panggilan VsDevCmd.bat untuk menyiapkan lingkungan arsitektur build yang ditentukan. Penginstalan umum dapat mencakup file perintah ini:

File Perintah	Arsitektur Host dan Target
vcvars32.bat	Gunakan alat x86-native 32-bit untuk membangun kode x86 32-bit.
vcvars64.bat	Gunakan alat 64-bit x64-native untuk membangun kode x64 64-bit.
vcvarsx86_amd64.bat	Gunakan alat silang x86-native 32-bit untuk membangun kode x64 64-bit.
vcvarsamd64_x86.bat	Gunakan alat silang 64-bit x64-native untuk membangun kode x86 32-bit.
vcvarsx86_arm.bat	Gunakan alat silang x86-native 32-bit untuk membangun kode ARM.
vcvarsamd64_arm.bat	Gunakan alat silang 64-bit x64-native untuk membangun kode ARM.
vcvarsx86_arm64.bat	Gunakan alat silang x86-native 32-bit untuk membangun kode ARM64.
vcvarsamd64_arm64.bat	Gunakan alat silang 64-bit x64-native untuk membangun kode ARM64.
vcvarsall.bat	Gunakan parameter untuk menentukan arsitektur host dan target, Windows SDK, dan pilihan platform. Untuk daftar opsi yang didukung, panggil dengan menggunakan /help parameter .

Perhatian

File vcvarsall.bat dan file perintah Visual Studio lainnya dapat bervariasi dari komputer ke komputer. Jangan ganti berkas yang hilang atau rusak vcvarsall.bat dengan menggunakan berkas dari komputer lain. Jalankan ulang alat penginstal Visual Studio untuk menggantikan file yang hilang.

File vcvarsall.bat juga bervariasi dari versi ke versi. Jika versi Visual Studio saat ini diinstal di komputer yang juga memiliki versi Visual Studio yang lebih lama, jangan jalankan vcvarsall.bat atau file perintah Visual Studio lain dari versi yang berbeda di jendela prompt perintah yang sama.

Menggunakan alat pengembang di jendela perintah yang sudah ada

Cara paling sederhana untuk menentukan arsitektur build tertentu di jendela perintah yang ada adalah dengan menggunakan vcvarsall.bat file . Gunakan vcvarsall.bat untuk mengatur variabel lingkungan untuk mengonfigurasi baris perintah untuk kompilasi 32-bit atau 64-bit asli. Argumen memungkinkan Anda menentukan kompilasi silang ke prosesor x86, x64, ARM, atau ARM64. Anda dapat menargetkan platform Microsoft Store, Platform Windows Universal, atau Windows Desktop. Anda bahkan dapat menentukan Windows SDK mana yang akan digunakan, dan memilih versi toolset platform.

Saat digunakan tanpa argumen, vcvarsall.bat mengonfigurasi variabel lingkungan untuk menggunakan kompilator x86-native saat ini untuk target Windows Desktop 32-bit. Anda dapat menambahkan argumen untuk mengonfigurasi lingkungan untuk menggunakan salah satu alat pengkompilasi asli atau silang. vcvarsall.bat menampilkan pesan kesalahan jika Anda menentukan konfigurasi yang tidak terinstal, atau tidak tersedia di komputer Anda.

vcvarsall sintaks

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

architecture
Argumen opsional ini menentukan arsitektur host dan target yang akan digunakan. Jika arsitektur tidak ditentukan, lingkungan build default akan digunakan. Argumen ini didukung:

architecture	Kompilator	Arsitektur komputer host	Arsitektur output build (target)
x86	x86 32-bit asli	x86, x64	x86
x86_amd64 atau x86_x64	x64 pada x86 silang	x86, x64	x64
x86_arm	ARM pada x86 cross	x86, x64	ARM
x86_arm64	ARM64 pada x86 cross	x86, x64	ARM64
amd64 atau x64	x64 64-bit asli	x64	x64
amd64_x86 atau x64_x86	x86 pada x64 silang	x64	x86
amd64_arm atau x64_arm	ARM pada x64 cross	x64	ARM
amd64_arm64 atau x64_arm64	ARM64 pada x64 cross	x64	ARM64

platform_type
Argumen opsional ini memungkinkan Anda menentukan store atau uwp sebagai jenis platform. Secara default, lingkungan diatur untuk membangun aplikasi desktop atau konsol.

winsdk_version
Secara opsional menentukan versi Windows SDK yang akan digunakan. Secara default, Windows SDK terbaru yang diinstal digunakan. Untuk menentukan versi Windows SDK, Anda dapat menggunakan nomor Windows SDK lengkap seperti 10.0.10240.0, atau menentukan 8.1 untuk menggunakan Windows 8.1 SDK.

vcversion
Secara opsional menentukan toolset pengkompilasi Visual Studio untuk digunakan. Secara default, lingkungan diatur untuk menggunakan toolset pengkompilasi Visual Studio saat ini.

Gunakan -vcvars_ver=14.2x.yyyyy untuk menentukan versi tertentu dari toolset kompilator Visual Studio 2019.

Gunakan -vcvars_ver=14.29 untuk menentukan versi terbaru dari toolset pengkompilasi Visual Studio 2019.

Gunakan -vcvars_ver=14.0 untuk menentukan toolset pengkompilasi Visual Studio 2015.

spectre_mode
Biarkan parameter ini keluar untuk menggunakan pustaka tanpa mitigasi Spectre. Gunakan nilai spectre untuk menggunakan pustaka dengan mitigasi Spectre.

Untuk menyiapkan lingkungan build di jendela prompt perintah yang ada

1. Pada prompt perintah, gunakan perintah CD untuk mengubah ke direktori penginstalan Visual Studio. Kemudian, gunakan CD lagi untuk mengubah ke subdirektori yang berisi file perintah khusus konfigurasi. Untuk Visual Studio 2019 dan Visual Studio 2017, gunakan subdirektori VC\Auxiliary\Build . Untuk Visual Studio 2015, gunakan subdirektori VC .

2. Masukkan perintah untuk lingkungan pengembang pilihan Anda. Misalnya, untuk membangun kode ARM untuk UWP pada platform 64-bit, menggunakan toolset pengkompilasi Windows SDK dan Visual Studio terbaru, gunakan baris perintah ini:

   vcvarsall.bat amd64_arm uwp

Membuat pintasan perintah Anda sendiri

Buka dialog Properti untuk pintasan perintah pengembang untuk melihat target perintah yang digunakan. Misalnya, target untuk x64 Native Tools Command Prompt untuk pintasan VS 2019 adalah sesuatu yang mirip dengan:

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

File batch khusus arsitektur mengatur architecture parameter dan memanggil vcvarsall.bat. Anda dapat meneruskan opsi yang sama ke file batch ini seperti yang akan Anda teruskan ke vcvarsall.bat, atau Anda hanya dapat menelepon vcvarsall.bat langsung. Untuk menentukan parameter untuk pintasan perintah Anda sendiri, tambahkan ke akhir perintah dalam tanda kutip ganda. Misalnya, berikut adalah pintasan untuk membangun kode ARM untuk UWP pada platform 64-bit, menggunakan Windows SDK terbaru. Untuk menggunakan kumpulan alat pengkompilasi sebelumnya, tentukan nomor versi. Gunakan sesuatu seperti target perintah ini di pintasan Anda:

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

Sesuaikan jalur untuk mencerminkan direktori penginstalan Visual Studio Anda. File vcvarsall.bat memiliki informasi tambahan tentang nomor versi tertentu.

Alat baris perintah

Untuk membangun proyek C/C++ pada prompt perintah, Visual Studio menyediakan alat baris perintah ini:

CL
Gunakan pengkompilasi (cl.exe) untuk mengkompilasi dan menautkan file kode sumber ke dalam aplikasi, pustaka, dan DLL.

Link
Gunakan linker (link.exe) untuk menautkan file objek dan pustaka yang dikompilasi ke dalam aplikasi dan DLL.

Saat Anda membangun pada baris perintah, perintah F1 tidak tersedia untuk bantuan instan. Sebagai gantinya, Anda dapat menggunakan mesin pencari untuk mendapatkan informasi tentang peringatan, kesalahan, dan pesan. Anda juga dapat mengunduh dan menggunakan file bantuan offline. Untuk menggunakan pencarian di Microsoft Learn, masukkan kueri Anda di kotak pencarian di bagian atas artikel apa pun.

Alat manajemen proyek baris perintah

Secara default, VISUAL Studio IDE menggunakan sistem build proyek asli berdasarkan MSBuild. Anda dapat memanggil MSBuild secara langsung untuk membangun proyek tanpa menggunakan IDE. Anda juga dapat menggunakan devenv perintah untuk menggunakan Visual Studio untuk membangun proyek dan solusi. Visual Studio juga mendukung sistem build berdasarkan CMake atau NMake.

MSBuild
Gunakan MSBuild (msbuild.exe) dan file proyek (.vcxproj) untuk mengonfigurasi build dan memanggil toolset tanpa memuat IDE Visual Studio. Ini setara dengan menjalankan perintah Build project atau Build Solution di Visual Studio IDE. MSBuild memiliki keunggulan dibandingkan IDE saat Anda membangun di baris perintah. Anda tidak perlu menginstal IDE lengkap di semua server build dan membangun alur. Anda menghindari overhead ekstra IDE. MSBuild berjalan di lingkungan build kontainer, dan mendukung pencatat biner.

DEVENV
Gunakan DEVENV (devenv.exe) yang dikombinasikan dengan sakelar baris perintah seperti /Build atau /Clean untuk menjalankan perintah build tertentu tanpa menampilkan IDE Visual Studio.

CMake
CMake (cmake.exe) adalah alat sumber terbuka lintas platform untuk menentukan proses build yang berjalan di beberapa platform. CMake dapat mengonfigurasi dan mengontrol alat build asli untuk platform yang didukung, seperti MSBuild dan Make. Untuk informasi selengkapnya tentang CMake, lihat dokumentasi CMake.

NMAKE
Gunakan NMAKE (nmake.exe) untuk membangun proyek C++ dengan menggunakan makefile tradisional.

Catatan

Mulai visual Studio 2019 versi 16.5, MSBuild dan DEVENV tidak menggunakan lingkungan baris perintah untuk mengontrol set alat dan pustaka yang digunakan.

Di bagian ini

Artikel ini menunjukkan cara membuat aplikasi di baris perintah, dan menjelaskan cara menyesuaikan lingkungan build baris perintah. Beberapa menunjukkan cara menggunakan toolset 64-bit, dan platform x86, x64, ARM, dan ARM64 target. Mereka juga menjelaskan penggunaan alat build baris perintah MSBuild dan NMAKE.

Panduan: Mengkompilasi program C++ asli pada baris perintah
Memberikan contoh yang menunjukkan cara membuat dan mengkompilasi program C++ pada baris perintah.

Panduan: Mengkompilasi program C pada baris perintah
Menjelaskan cara mengkompilasi program yang ditulis dalam bahasa pemrograman C.

Panduan: Mengkompilasi program C++/CLI pada baris perintah
Menjelaskan cara membuat dan mengkompilasi program C++/CLI yang menggunakan .NET Framework.

Panduan: Mengkompilasi program C++/CX pada baris perintah
Menjelaskan cara membuat dan mengkompilasi program C++/CX yang menggunakan Windows Runtime.

Referensi NMAKE
Menyediakan tautan ke artikel yang menjelaskan Utilitas Pemeliharaan Program Microsoft (NMAKE.EXE).

MSBuild pada baris perintah - C++
Menyediakan tautan ke artikel yang membahas cara menggunakan msbuild.exe dari baris perintah.

Bagian terkait

/MD, /MT, /LD (Gunakan pustaka run-time)
Menjelaskan cara menggunakan opsi pengkompilasi ini untuk menggunakan pustaka run-time Debug atau Rilis.

Opsi pengkompilasi C/C++
Menyediakan tautan ke artikel yang membahas opsi pengkompilasi C dan C++ dan CL.exe.

Opsi linker MSVC
Menyediakan tautan ke artikel yang membahas opsi linker dan LINK.exe.

Alat build MSVC tambahan
Menyediakan tautan ke alat build C/C++ yang disertakan dalam Visual Studio.

Baca juga

Proyek dan sistem build