Share via

/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Tingkat peringatan)

  • Artikel

Menentukan bagaimana pengkompilasi menghasilkan peringatan untuk kompilasi tertentu.

Sintaks

/W
/W0
/W1
/W2
/W3
/W4
/Dinding
/Wv[:version]
/WX
Peringatan /w1
Peringatan /w2
Peringatan /w3
Peringatan /w4
Peringatan /wd
/ kamimemperingatkan
Peringatan /wo

Keterangan

Opsi peringatan menentukan peringatan pengkompilasi mana yang akan ditampilkan dan perilaku peringatan untuk seluruh kompilasi.

Opsi peringatan dan argumen terkait dijelaskan dalam tabel berikut:

Opsi Deskripsi
/W Menekan semua peringatan pengompilasi.
/W0

/W1

/W2

/W3

/W4		 Menentukan tingkat peringatan yang akan dihasilkan oleh pengkompilasi. Tingkat peringatan yang valid berkisar antara 0 hingga 4:
/W0 menekan semua peringatan. Ini setara dengan /w.
/W1 menampilkan peringatan tingkat 1 (parah). /W1 adalah pengaturan default dalam pengkompilasi baris perintah.
/W2 menampilkan peringatan tingkat 1 dan tingkat 2 (signifikan).
/W3 menampilkan peringatan tingkat 1, tingkat 2, dan tingkat 3 (kualitas produksi). /W3 adalah pengaturan default dalam IDE.
/W4 menampilkan peringatan tingkat 1, tingkat 2, dan tingkat 3, dan semua peringatan tingkat 4 (informasi) yang tidak nonaktif secara default. Kami menyarankan agar Anda menggunakan opsi ini untuk memberikan peringatan seperti lint. Untuk proyek baru, mungkin yang terbaik adalah menggunakan /W4 di semua kompilasi. Opsi ini membantu memastikan cacat kode paling sedikit yang mungkin sulit ditemukan.
/Dinding Menampilkan semua peringatan yang ditampilkan oleh /W4 dan semua peringatan lain yang tidak disertakan /W4 —misalnya, peringatan yang nonaktif secara default. Untuk informasi selengkapnya, lihat Peringatan pengkompilasi yang nonaktif secara default.
/Wv[:version] Hanya menampilkan peringatan yang diperkenalkan dalam versi pengompilasi versi dan versi sebelumnya. Anda dapat menggunakan opsi ini untuk menekan peringatan baru dalam kode saat Anda bermigrasi ke versi pengompilasi yang lebih baru. Ini memungkinkan Anda mempertahankan proses build yang ada saat Anda memperbaikinya. Versi parameter opsional mengambil formulir nn[.mm[.bbbbb]], di mana nn adalah nomor versi utama, mm adalah nomor versi minor opsional, dan bbbbb adalah nomor build opsional dari pengkompilasi. Misalnya, gunakan /Wv:17 untuk menampilkan hanya peringatan yang diperkenalkan di Visual Studio 2012 (versi utama 17) atau yang lebih lama. Artinya, ini menampilkan peringatan dari versi pengkompilasi apa pun yang memiliki nomor versi utama 17 atau kurang. Ini menekan peringatan yang diperkenalkan di Visual Studio 2013 (versi utama 18) dan yang lebih baru. Secara default, /Wv menggunakan nomor versi pengompilasi saat ini, dan tidak ada peringatan yang ditekan. Untuk informasi tentang peringatan mana yang ditekan oleh versi kompilator, lihat Mengompilasi peringatan dengan versi pengompilasi.
/WX Perlakukan semua peringatan pengompilasi sebagai kesalahan. Untuk proyek baru, mungkin yang terbaik adalah menggunakan /WX di semua kompilasi; menyelesaikan semua peringatan memastikan cacat kode yang sulit ditemukan sekecil mungkin.

Linker juga memiliki opsi /WX . Untuk informasi lebih lanjut, lihat /WX (Memperlakukan peringatan penaut sebagai kesalahan).

Opsi berikut saling eksklusif satu sama lain. Opsi terakhir yang ditentukan dari grup ini adalah opsi yang diterapkan:

Opsi Deskripsi
/w1nnnn

/w2nnnn

/w3nnnn

/w4nnnn		 Mengatur tingkat peringatan untuk nomor peringatan yang ditentukan oleh nnnn. Opsi ini memungkinkan Anda mengubah perilaku pengkompilasi untuk peringatan tersebut saat tingkat peringatan tertentu diatur. Anda dapat menggunakan opsi ini dalam kombinasi dengan opsi peringatan lain untuk menerapkan standar pengodean Anda sendiri untuk peringatan, bukan yang default yang disediakan oleh Visual Studio.

Misalnya, /w34326 menyebabkan C4326 dihasilkan sebagai peringatan tingkat 3 alih-alih tingkat 1. Jika Anda mengkompilasi dengan menggunakan opsi /w34326 dan opsi /W2 , peringatan C4326 tidak dihasilkan.
/wdnnnn Menekan peringatan kompilator yang ditentukan oleh nnnn.

Misalnya, /wd4326 menekan peringatan pengompilasi C4326.
Kami nnnn Memperlakukan peringatan kompilator yang ditentukan oleh nnnn sebagai kesalahan.

Misalnya, /we4326 menyebabkan nomor peringatan C4326 diperlakukan sebagai kesalahan oleh pengkompilasi.
/wonnnn Melaporkan peringatan kompilator yang ditentukan oleh nnnn hanya sekali.

Misalnya, /wo4326 menyebabkan peringatan C4326 dilaporkan hanya sekali, pertama kali ditemui oleh pengkompilasi.

Jika Anda menggunakan opsi peringatan saat Anda membuat header yang telah dikommpilasikan sebelumnya, itu akan menyimpan pengaturan tersebut. Menggunakan header yang telah dikommpilasikan membuat opsi peringatan yang sama berlaku lagi. Untuk mengesampingkan opsi peringatan header yang telah dikomparasi sebelumnya, atur opsi peringatan lain pada baris perintah.

Anda dapat menggunakan direktif peringatan #pragma untuk mengontrol tingkat peringatan yang dilaporkan pada waktu kompilasi dalam file sumber tertentu.

Petunjuk pragma peringatan dalam kode sumber tidak terpengaruh oleh opsi /w .

Dokumentasi kesalahan build menjelaskan tingkat peringatan dan peringatan, dan menunjukkan mengapa pernyataan tertentu mungkin tidak dikompilasi seperti yang Anda inginkan.

Untuk mengatur opsi pengkompilasi di lingkungan pengembangan Visual Studio

  1. Buka kotak dialog Halaman Properti proyek. Untuk detailnya, lihat Mengatur pengkompilasi C++ dan membuat properti di Visual Studio.

  2. Untuk mengatur opsi /W0, /W1, /W2, /W3, /W4, /Wall, /Wv, /WX, atau /WX- , pilih Properti>Konfigurasi C/C++>General.

    • Untuk mengatur opsi /W0, /W1, /W2, /W3, /W4, atau /Wall , ubah properti Tingkat Peringatan.

    • Untuk mengatur opsi /WX atau /WX- , ubah properti Perlakukan Peringatan sebagai Kesalahan .

    • Untuk mengatur versi untuk opsi /Wv , masukkan nomor versi pengkompilasi di properti Versi Peringatan.

  3. Untuk mengatur opsi /wd atau /we, pilih halaman properti Properti>Konfigurasi C/C++>Tingkat Lanjut.

    • Untuk mengatur opsi /wd , pilih kontrol dropdown Nonaktifkan properti Peringatan Tertentu lalu pilih Edit. Dalam kotak edit dalam dialog Nonaktifkan Peringatan Tertentu, masukkan nomor peringatan. Untuk memasukkan lebih dari satu peringatan, pisahkan nilai dengan menggunakan titik koma (;). Misalnya, untuk menonaktifkan C4001 dan C4010, masukkan 4001; 4010. Pilih OK untuk menyimpan perubahan Anda dan kembali ke dialog Halaman Properti.

    • Untuk mengatur opsi /we , Pilih kontrol dropdown properti Perlakukan Peringatan Tertentu Sebagai Kesalahan lalu pilih Edit. Dalam kotak edit dalam dialog Perlakukan Peringatan Tertentu Sebagai Kesalahan , masukkan nomor peringatan. Untuk memasukkan lebih dari satu peringatan, pisahkan nilai dengan menggunakan titik koma (;). Misalnya, untuk memperlakukan C4001 dan C4010 sebagai kesalahan, masukkan 4001; 4010. Pilih OK untuk menyimpan perubahan Anda dan kembali ke dialog Halaman Properti.

  4. Untuk mengatur opsi /wo, pilih halaman properti Properti>Konfigurasi C/C++>Baris Perintah. Masukkan opsi pengkompilasi dalam kotak Opsi Tambahan.

  5. Pilih OK untuk menyimpan perubahan.

Untuk mengatur opsi pengkompilasi secara terprogram

Baca juga

Opsi pengkompilasi MSVC
Sintaks baris perintah pengkompilasi MSVC