Tutorial: Men-debug aplikasi konsol .NET menggunakan Visual Studio Code

Tutorial ini memperkenalkan alat debugging yang tersedia di Visual Studio Code untuk mengembangkan aplikasi .NET.

Tutorial ini memperkenalkan alat debugging yang tersedia di GitHub Codespaces untuk bekerja dengan aplikasi .NET.

Prasyarat

Tutorial ini berfungsi dengan aplikasi konsol yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.

Mengatur titik henti

Titik henti untuk sementara mengganggu eksekusi aplikasi sebelum baris dengan titik henti dijalankan.

Mulai Visual Studio Code.
Buka folder proyek yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.
Buka file Program.cs.
Atur titik henti pada baris yang menampilkan nama, tanggal, dan waktu, dengan mengklik di margin kiri jendela kode. Margin kiri berada di sebelah kiri nomor baris. Cara lain untuk mengatur titik henti adalah dengan menekan F9 atau memilih Jalankan>Ganti Titik Henti dari menu saat baris kode dipilih.

Visual Studio Code menunjukkan garis tempat titik henti diatur dengan menampilkan titik merah di margin kiri.

Buka GitHub Codespace yang Anda buat di Membuat aplikasi konsol .NET menggunakan Visual Studio Code.
Buka file HelloWorld.cs .
Atur titik henti pada baris yang menampilkan nama, tanggal, dan waktu, dengan mengklik di margin kiri jendela kode. Margin kiri berada di sebelah kiri nomor baris. Anda juga dapat mengatur titik henti adalah dengan menekan F9 saat baris kode dipilih.

Mulai debug

Debug dan Release adalah konfigurasi build bawaan .NET. Anda menggunakan konfigurasi build Debug untuk penelusuran kesalahan dan konfigurasi Rilis untuk distribusi rilis akhir.

Secara default, pengaturan peluncuran Visual Studio Code menggunakan konfigurasi build Debug, sehingga Anda tidak perlu mengubahnya sebelum men-debug.

Buka tampilan Debug dengan memilih ikon Debugging di menu sisi kiri.
Pilih Jalankan dan Debug. Jika diminta, pilih C# lalu pilih C#: Luncurkan proyek startup. Cara lain untuk memulai program dalam mode debugging adalah dengan menekan F5 atau memilih Jalankan>Mulai Debugging dari menu.
Jika diminta untuk Pilih Konfigurasi Peluncuran, pilih C#: Debug File Aktif.
Pilih tab Konsol Debug untuk melihat perintah "Apa nama Anda?" yang ditampilkan program sebelum menunggu respons.
Masukkan string di jendela Konsol Debug sebagai respons terhadap permintaan nama, lalu tekan Enter.

Eksekusi program berhenti ketika mencapai titik henti dan sebelum Console.WriteLine metode berjalan. Bagian Lokal dari jendela Variabel menampilkan nilai variabel yang ditentukan dalam metode yang sedang berjalan.

Secara default, GitHub Codespaces menggunakan konfigurasi build Debug, jadi Anda tidak perlu mengubahnya sebelum debugging.

Buka tampilan Debug dengan memilih ikon Debugging di menu sisi kiri.
Pilih Jalankan dan Debug. Jika diminta, pilih C# sebagai debugger lalu pilih C#: Debug File Aktif sebagai Konfigurasi Peluncuran.
Pilih tab Konsol Debug untuk melihat perintah "Apa nama Anda?" yang ditampilkan program sebelum menunggu respons.
Masukkan string di jendela Konsol Debug sebagai respons terhadap permintaan nama, lalu tekan Enter.

Eksekusi program berhenti ketika mencapai titik henti dan sebelum Console.WriteLine metode berjalan. Bagian Lokal dari jendela Variabel menampilkan nilai variabel yang ditentukan dalam metode yang sedang berjalan.

Menggunakan Konsol Debug

Jendela Konsol Debug memungkinkan Anda berinteraksi dengan aplikasi yang Sedang Anda debug. Anda dapat mengubah nilai variabel untuk melihat pengaruhnya terhadap program Anda.

Pilih tab Konsol Debug .
Masukkan name = "Gracie" pada perintah di bagian bawah jendela Konsol Debug dan tekan Enter.
Masukkan currentDate = DateTime.Parse("2026-01-28T20:54:00Z").ToUniversalTime() di bagian bawah jendela Konsol Debug dan tekan Enter.

Jendela Variabel menampilkan nilai baru variabel name dan currentDate .
Lanjutkan eksekusi program dengan memilih tombol Lanjutkan di bilah alat. Cara lain untuk melanjutkan adalah dengan menekan F5.

Nilai yang ditampilkan di jendela konsol sesuai dengan perubahan yang Anda buat di Konsol Debug.
Tekan Enter untuk keluar dari aplikasi dan hentikan debug.

Mengatur titik henti bersyarat

Program menampilkan untai (karakter) yang dimasukkan pengguna. Apa yang terjadi jika pengguna tidak memasukkan apa pun? Anda dapat mengujinya dengan fitur debugging berguna yang disebut titik henti kondisional.

Klik kanan (Ctrl-klik pada macOS) pada titik merah yang mewakili titik henti. Pada menu konteks, pilih Edit Titik Henti untuk membuka dialog dan memasukkan ekspresi kondisional.
Pilih Expression di menu drop-down, masukkan ekspresi bersyarah berikut, dan tekan Enter.
```
String.IsNullOrEmpty(name)
```
Setiap kali titik henti tercapai, debugger memanggil metode String.IsNullOrEmpty(name), dan berhenti pada baris ini hanya jika panggilan metode menghasilkan true.

Alih-alih ekspresi kondisional, Anda dapat menentukan hit count, yang mengganggu eksekusi program sebelum pernyataan dijalankan beberapa kali. Opsi lain adalah menentukan kondisi filter , yang mengganggu eksekusi program berdasarkan atribut seperti pengidentifikasi utas, nama proses, atau nama utas.
Mulai program dengan debugging dengan menekan F5.
Di tab Konsol Debug , tekan Enter saat diminta untuk memasukkan nama Anda.

Karena kondisi yang Anda tentukan (name adalah null atau String.Empty) telah terpenuhi, eksekusi program berhenti ketika mencapai titik henti dan sebelum Console.WriteLine metode berjalan.

Jendela Variabel menunjukkan bahwa nilai name variabel adalah "", atau String.Empty.
Konfirmasikan nilainya adalah string kosong dengan memasukkan pernyataan berikut di prompt Konsol Debug dan menekan Enter. Hasilnya adalah true.
```
name == String.Empty
```
Pilih tombol Lanjutkan pada toolbar untuk melanjutkan eksekusi program.
Tekan Enter untuk keluar dari program dan menghentikan debugging.
Hapus titik henti dengan mengklik titik di margin kiri jendela kode. Cara lain untuk menghapus titik henti adalah dengan menekan F9 atau memilih Jalankan > Ganti Titik Henti dari menu saat baris kode dipilih.
Jika Anda mendapatkan peringatan bahwa kondisi titik henti akan hilang, pilih Hapus Titik Henti.

Menjalankan program langkah demi langkah

Visual Studio Code juga memungkinkan Anda untuk melangkah baris demi baris melalui program dan memantau eksekusinya. Biasanya, Anda akan mengatur titik henti dan mengikuti alur program melalui sebagian kecil kode program Anda. Karena program ini kecil, Anda dapat melalui keseluruhan program langkah demi langkah.

Atur titik henti pada baris kode yang menampilkan perintah "Apa nama Anda?".
Tekan F5 untuk memulai debugging.

Visual Studio Code menyoroti garis titik henti.

Pada titik ini, jendela Variabel menunjukkan bahwa args array kosong, dan namecurrentDate memiliki nilai default.
Pilih Langkah Masuk dari bilah alat Debug atau tekan F11.

Visual Studio Code menyoroti baris berikutnya.
Visual Studio Code menjalankan Console.WriteLine untuk perintah nama dan menyoroti baris eksekusi berikutnya. Baris berikutnya adalah Console.ReadLine untuk name. Jendela Variabel tidak berubah, dan tab Terminal menunjukkan perintah "Apa nama Anda?".
Pilih Masuk atau tekan F11.

Visual Studio Code menyoroti penugasan variabel name. Jendela Variabel menunjukkan bahwa name masih null.
Tanggapi perintah dengan memasukkan string di tab Terminal dan menekan Enter.

Tab Konsol Debug mungkin tidak menampilkan string yang Anda masukkan saat Anda memasukkannya, tetapi Console.ReadLine metode akan mengambil input Anda.
Pilih Masuk atau tekan F11.

Visual Studio Code menyoroti variabel penetapan currentDate. Jendela Variabel menunjukkan nilai yang dikembalikan oleh panggilan ke Console.ReadLine metode . Tab Terminal menampilkan string yang Anda masukkan saat diminta.
Pilih Masuk atau tekan F11.

Jendela Variabel menunjukkan nilai currentDate variabel setelah penugasan dari DateTime.Now properti .
Pilih Masuk atau tekan F11.

Visual Studio Code memanggil Console.WriteLine(String, Object, Object) metode . Jendela konsol menampilkan string yang diformat.
Pilih Keluar atau tekan Shift+F11.

Terminal menampilkan "Tekan tombol apa pun untuk keluar..."
Tekan tombol apa pun untuk keluar dari program.

Gunakan konfigurasi build rilis

Setelah menguji versi Debug aplikasi, Anda juga harus mengkompilasi dan menguji versi Rilis. Versi Rilis menggabungkan pengoptimalan pengkompilasi yang dapat memengaruhi perilaku aplikasi. Misalnya, pengoptimalan kompilator yang dirancang untuk meningkatkan performa dapat menciptakan kondisi balapan di aplikasi multithread.

Untuk membangun dan menguji versi Rilis aplikasi konsol Anda, buka Terminal dan jalankan perintah berikut:

dotnet run --configuration Release

Untuk membuat dan menguji versi Rilis aplikasi konsol Anda, jalankan perintah berikut di terminal:

dotnet run --configuration Release HelloWorld.cs

Langkah selanjutnya

Dalam tutorial ini, Anda menggunakan alat debug Visual Studio Code. Dalam tutorial berikutnya, Anda menerbitkan versi aplikasi yang dapat disebarkan.

Menerbitkan aplikasi konsol .NET menggunakan Visual Studio Code

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-02-05