Menggunakan Microsoft C++ Build Tools dari baris perintah

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

Mengunduh dan menginstal alat

Cara menggunakan alat baris perintah

Saat Anda memilih salah satu beban kerja C++ di penginstal Visual Studio, ia menginstal versi tertentu dari paket MSVC Build Tools secara default. Untuk Visual Studio 2022 dan yang lebih lama, paket diatur oleh toolset platform (format versi v###) yang menyertakan semua alat C dan C++ untuk versi Visual Studio tertentu. Dimulai dengan Visual Studio 2026, versi MSVC dipisahkan dari versi Visual Studio. Dengan kata lain, dari Visual Studio 2026 dan seterusnya paket sesuai dengan versi toolset MSVC (format versi v##.##), yang mencakup semua alat C dan C++ untuk paket MSVC Build Tools tertentu.

Alat-alat ini mencakup kompiler C/C++, penaut, perakit, dan alat bantu pembangunan lainnya. Ini mencakup pustaka yang sesuai dan berkas header. Anda dapat menggunakan semua alat ini di baris perintah. Visual Studio IDE menggunakannya secara internal. Ada kompilator dan alat terpisah yang dihosting oleh x86 dan x64, yang membangun kode untuk target x86, x64, ARM, dan ARM64. Setiap set alat untuk arsitektur build host dan target tertentu disimpan di direktorinya sendiri.

Alat ini memerlukan beberapa variabel lingkungan untuk diatur. Variabel ini menambahkan alat ke jalur dan 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 kompilasi host dan target tertentu, versi SDK Windows, dan set alat platform.

Untuk kenyamanan, alat penginstal juga membuat pintasan di menu Mulai Anda. Pintasan ini membuka jendela Command Prompt pengembang dengan menggunakan berkas perintah ini untuk kombinasi arsitektur 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. Pembaruan atau peningkatan produk dapat mengubah variabel. 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 ditambahkan alat penginstal bergantung pada prosesor komputer Anda dan opsi yang Anda pilih selama penginstalan. Alat yang berjalan di atas x86 dan alat lintas-kompilasi untuk menyusun 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, alat x86 dan x64 yang membangun kode ARM dan ARM64 juga diinstal. Beban kerja lain dapat menginstal alat-alat ini.

Variabel jalur dan lingkungan untuk build baris perintah

Alat baris perintah MSVC menggunakan PATHvariabel lingkungan , , TMPINCLUDE, LIB, dan LIBPATH . Mereka 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 command prompt 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 command prompt pengembang, gunakan perintah SET. Buka jendela Command Prompt standar dan catat output dari perintah SET sebagai nilai acuan. Buka jendela Command Prompt pengembang dan catat output perintah SET untuk dibandingkan. Gunakan alat diff seperti yang disertakan dalam 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 Command Prompt diinstal dalam folder Visual Studio khusus versi tertentu pada menu Windows Start Anda. Berikut adalah daftar perintah dasar command prompt dan arsitektur build yang mereka dukung:

• Prompt Perintah Pengembang. Mengatur lingkungan untuk menggunakan alat x86 32-bit untuk membangun kode x86 32-bit.
• Perintah Alat Asli x86. Mengatur lingkungan untuk menggunakan alat x86 32-bit untuk membangun kode x86 32-bit.
• Perintah Alat Asli x64. Mengatur lingkungan untuk menggunakan alat x64 64-bit untuk membangun kode x64 64-bit.
• Prompt Perintah Alat Lintas x86_x64. Mengatur lingkungan untuk menggunakan alat x86 32-bit untuk membangun kode x64 64-bit.
• Prompt Perintah Alat Lintas x64_x86. Mengatur lingkungan untuk menggunakan alat x64 64-bit untuk membangun kode x86 32-bit.

Untuk membuka jendela Command Prompt pengembang

1. Di desktop, buka menu Windows Start. Di Windows 11, pilih 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, seperti Visual Studio 2022 atau Visual Studio untuk versi 2026 dan yang lebih baru.
2. Di folder, pilih Prompt Perintah Developer untuk versi Visual Studio Anda. Pintasan ini membuka jendela Command Prompt Pengembang yang menyiapkan lingkungan untuk menggunakan alat x86 32-bit guna mengompilasi kode x86 32-bit. Jika Anda lebih memilih arsitektur build yang bukan default, pilih salah satu prompt perintah Native Tools atau Cross Tools 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.

Lokasi file perintah pengembang

Jika Anda ingin mengatur lingkungan build di jendela Command Prompt yang sudah terbuka, Anda dapat menggunakan salah satu file skrip perintah yang dibuat oleh penginstal. Kami sarankan Anda mengatur lingkungan pada jendela Prompt Perintah yang baru. Kami tidak menyarankan Anda beralih lingkungan nanti di jendela perintah yang sama.

File perintah pengembang utama, VsDevCmd.bat, terletak di Common7\Tools direktori. Saat Anda tidak menentukan parameter, ini mengatur lingkungan untuk menggunakan alat x86-native untuk membangun kode x86 32-bit.

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

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 guna mengonfigurasi jendela Command Prompt untuk kompilasi native 32-bit atau 64-bit. 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 SDK Windows mana yang akan digunakan, dan memilih versi toolset platform.

Saat Anda menggunakan vcvarsall.bat tanpa argumen, ia mengonfigurasi variabel lingkungan untuk menggunakan kompilator x86-native saat ini untuk target Desktop Windows 32-bit. Tambahkan argumen untuk mengonfigurasi lingkungan untuk menggunakan salah satu alat pengkompilasi asli atau silang. vcvarsall.bat menampilkan pesan kesalahan jika Anda menentukan konfigurasi yang tidak diinstal, 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 Anda tidak menentukan architecture, lingkungan build default digunakan. Argumen berikut 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 kompilasi 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 menentukan store atau uwp sebagai jenis platform. Secara default, lingkungan diatur untuk membangun aplikasi desktop atau konsol.

• winsdk_version

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

• vcversion

  Secara opsional menentukan kumpulan alat pengkompilasi Visual Studio untuk digunakan. Secara default, lingkungan menggunakan toolset pengkompilasi Visual Studio terbaru yang diinstal. Tabel berikut ini memperlihatkan contoh vcvars_ver nilai:

  vcvars_ver={value}	Result	Contoh VS 2026	Contoh VS 2022	Contoh VS 2019	Contoh VS 2017
  "Preview"	Gunakan kumpulan alat pengkompilasi pratinjau Visual Studio.	Supported	Tidak didukung	Tidak didukung	Tidak didukung
  "14.0"	Gunakan kumpulan alat pengkompilasi Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Gunakan toolset terbaru yang terinstal 14.xx.yyyyy .	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Gunakan nomor versi lengkap tertentu.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Hapus parameter ini untuk menggunakan pustaka tanpa pengamanan Spectre. Tetapkan spectre untuk menggunakan pustaka dengan mitigasi Spectre.

Untuk menyiapkan lingkungan build di jendela Command Prompt yang sudah terbuka

1. Pada prompt perintah, gunakan perintah CD untuk mengubah ke direktori penginstalan Visual Studio. Misalnya, C:\Program Files\Microsoft Visual Studio\18\Professional jika Anda menggunakan Visual studio 2026. Kemudian, gunakan CD lagi untuk mengubah ke subdirektori yang berisi file perintah khusus konfigurasi. Untuk Visual Studio 2017 dan seterusnya, 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 SDK Windows terbaru dan Visual Studio toolset kompilator, gunakan perintah ini:

   vcvarsall.bat amd64_arm uwp
   

Membuat pintasan perintah Anda sendiri

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvars64.bat"

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\Tools\VsDevCmd.bat"

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"

File batch khusus arsitektur mengatur architecture parameter dan memanggil vcvarsall.bat. Anda dapat meneruskan opsi yang sama ke file batch ini saat Anda meneruskan 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. Untuk menggunakan kumpulan alat pengkompilasi sebelumnya, tentukan nomor versi.

Anda hanya dapat menargetkan ARM64 dimulai dengan Visual Studio 2026 karena penargetan ARM32 dihapus kemudian.

Berikut adalah pintasan untuk membangun kode ARM64 untuk UWP pada platform 64-bit, menggunakan SDK Windows terbaru. Opsi penargetan ARM64 tersedia di Visual Studio 2026 dan versi yang lebih baru. Penargetan ke ARM32 ditampilkan pada versi yang lebih lama.

%comspec% /k "C:\Program Files\Microsoft Visual Studio\18\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm64 uwp -vcvars_ver=14.50

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

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0

Sesuaikan jalur untuk mencerminkan direktori penginstalan Visual Studio Anda. File vcvarsall.bat memiliki informasi lebih lanjut 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 menggunakan command line, perintah F1 tidak tersedia untuk bantuan cepat. 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 perintah devenv 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 Visual Studio IDE. Ini setara dengan menjalankan proyek Build atau Build Solution dalam 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 pipeline build. Anda menghindari beban tambahan dari 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 Visual Studio IDE.

• 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.

Lihat juga

• Panduan: Mengkompilasi program C++ asli pada baris perintah
• Panduan: Mengkompilasi program C pada baris perintah
• Panduan: Mengkompilasi program C++/CLI pada baris perintah
• Panduan: Mengkompilasi program C++/CX pada baris perintah
• Proyek dan sistem pengerjaan
• /MD, /MT, /LD (Gunakan pustaka run-time)
• Opsi pengkompilasi C/C++
• Opsi penghubung MSVC
• Alat build MSVC tambahan