Cara Membuka launch.json di VS Code
Effective debugging dan kualitas kode adalah konsep yang tidak terpisahkan dalam pengembangan perangkat lunak. Fungsionalitas debugging Visual Studio (VS) Code dikendalikan terutama oleh file launch.json. File ini memungkinkan pengembang mengonfigurasi dan mengelola pengaturan debugging mereka sesuai dengan visi mereka.
Artikel ini akan memandu Anda membuka dan mengelola file launch.json untuk debugging optimal.
Membuka launch.json di Visual Studio Code
Untuk mengonfigurasi dan mengelola pengaturan debugging VS Code, Anda akan memerlukan akses ke file launch.json. File ini memainkan peran penting dalam kustomisasi debug.
Buka Kode Visual Studio.Tekan Ctrl + Shift + P untuk membuka Palet Perintah. Ketik "Open launch.json" di Palet Perintah dan tekan "Enter." Ini akan membuka file launch.json untuk Anda. Jika file launch.json tidak terbuka, pastikan folder ".vscode" ada di folder root proyek Anda. Jika tidak ada, buat folder baru bernama ".json". vscode" di dalam folder Pengguna Anda. Buat file "launch.json" baru dan letakkan di folder ini.
File launch.json akan siap untuk dikonfigurasi setelah diaktifkan. Gambaran Umum Struktur
Launch.json
Launch.json menampilkan "versi" dan bagian "konfigurasi". Bagian "konfigurasi" adalah larik yang berisi opsi debug berbeda, yang akan Anda gunakan untuk mengonfigurasi skema debug Anda.
Setiap objek dalam larik "konfigurasi" mewakili skenario debug. Objek-objek ini memiliki properti yang menentukan lingkungan debug, seperti pengaturan bahasa, program, dan debugger.
Beberapa properti umum yang akan Anda temui di konfigurasi launch.json meliputi:
“nama” – Nama ramah pembaca untuk mengidentifikasi konfigurasi di menu tarik-turun.“type” – Menentukan jenis debugger (seperti “node”, “python”, atau “cppvsdbg”).“request” – Menentukan jenis permintaan, baik “launch” (untuk memulai yang baru instance) atau "lampirkan" (untuk melampirkan debugger ke proses yang ada). "program" – Jalur file untuk file yang ingin Anda debug. “args” – Array argumen baris perintah untuk diteruskan ke program selama proses debug. “preLaunchTask” – Tugas yang harus dijalankan sebelum memulai debugger.
Memahami struktur file launch.json memungkinkan Anda mengetahui opsi mana yang harus diubah dan mana yang harus dibiarkan sambil menyesuaikan lingkungan debug Anda. sedikit berbeda tergantung pada bahasa. Berikut adalah langkah-langkah untuk beberapa bahasa populer.
JavaScript dan TypeScript
Buat file launch.json baru dan konfigurasikan properti "type" sebagai "node" untuk JavaScript atau "pwa-node" untuk TypeScript.Atur properti "request" ke "launch" atau "lampirkan". Anda harus menentukan file titik masuk menggunakan properti "program". Properti "request" sebagai "launch" atau "attach". Tentukan file Python untuk dijalankan menggunakan properti "program". Anda mungkin perlu menyetel properti "pythonPath" ke jalur juru bahasa Python jika tidak berada di lokasi default. C# dan .NET Core
Instal ekstensi C# untuk Visual Studio Code. Di file launch.json yang baru, setel properti "type" ke "coreclr" untuk .NET Core atau "clr" untuk .NET Framework. Konfigurasikan "permintaan" properti sebagai "peluncuran" atau "lampirkan". Tentukan file titik masuk menggunakan properti "program". Atur properti "cwd" ke direktori kerja proyek saat ini jika perlu.Java
Instal Java Extension Pack.Buat file launch.json baru , dan setel properti "type" ke "java". Konfigurasikan properti "request" sebagai "launch" atau "attach". Tentukan kelas utama dengan properti "mainClass". Setel properti "projectName" ke nama Proyek Java.Konfigurasi properti “classpath” untuk menyertakan pustaka Java yang akan Anda gunakan selama pengembangan Java.Resep Konfigurasi Debugging
Bagian berikut mencakup berbagai resep konfigurasi debug.
Menyambungkan Debugger ke Proses yang Berjalan
Untuk memasang debugger ke proses yang sedang berjalan:
Atur properti "permintaan" untuk "lampirkan". Pilih ID proses atau filter untuk menemukan proses yang akan di-debug. Debugging Aplikasi Jarak Jauh
Untuk debugging aplikasi jarak jauh:
Gunakan jenis "jarak jauh". Berikan alamat host, port, dan mungkin informasi autentikasi untuk membuat connection.Debugging Unit Tests dan Test Suites
Saat men-debug unit test dan test suites:
Gunakan konfigurasi yang menyertakan kerangka pengujian dan pengaturan untuk men-debug pengujian unit dan suite pengujian.Tentukan test suite atau file pengujian individual dalam "program" atau "args" properti untuk menargetkan pengujian tertentu.Meneruskan Variabel Lingkungan
Properti "env" di launch.json dapat meneruskan variabel lingkungan ke aplikasi Anda saat melakukan debug. Properti ini adalah objek yang berisi pasangan kunci-nilai untuk variabel lingkungan yang ingin Anda atur.
Advanced Debugging
Mari jelajahi beberapa teknik debug tingkat lanjut untuk pengguna yang ingin memeras lebih banyak daya dari file debug.
Conditional Breakpoints dan Logpoints
Conditional breakpoints dan logpoints tingkatkan proses debug dengan menjeda atau mencatat pesan hanya dalam kondisi tertentu. Untuk menggunakannya:
Klik kanan pada nomor baris tempat Anda ingin menyetel breakpoint atau logpoint.Pilih “Add Conditional Breakpoint” atau “Add Logpoint”.Masukkan kondisi atau pesan untuk memicu tindakan.Source Maps
Source maps memungkinkan Anda untuk melakukan debug kode yang telah diubah atau diperkecil.
Atur properti "sourceMap" ke "true" dalam konfigurasi launch.json Anda untuk menggunakan peta sumber.Pastikan proses pembangunan Anda menghasilkan peta sumber dan kode yang diubah.Mengintegrasikan Debugger Eksternal
Anda dapat mengintegrasikan alat dan debugger eksternal , seperti gdb atau lldb, ke dalam VS Code jika Anda mau.
Instal ekstensi debugger pilihan.Konfigurasikan pengaturan debugger di file launch.json.Debugging Aplikasi Multi-Threaded
Saat men-debug aplikasi multi-threaded, Anda dapat mengontrol eksekusi individual threads.
Gunakan tampilan “utas” di sidebar Debug untuk mengelola utas selama sesi debug. Anda dapat menjeda, melanjutkan, atau menelusuri eksekusi kode untuk setiap utas secara terpisah. Debugging Multi-Target
Konfigurasi peluncuran gabungan mengaktifkan debug beberapa target secara bersamaan . Jika Anda ingin memanfaatkan fitur ini, tambahkan larik "senyawa" dengan nama konfigurasi untuk dikelompokkan bersama. Jalankan dengan memilih nama konfigurasi gabungan dari menu tarik-turun Debug.
Konfigurasikan beberapa konfigurasi peluncuran yang menargetkan berbagai layanan, fungsi, atau titik akhir untuk men-debug layanan mikro dan aplikasi tanpa server. Gunakan konfigurasi peluncuran gabungan untuk menjalankan target ini bersama-sama.
Untuk ruang kerja multi-root, buat file launch.json terpisah untuk setiap folder. Konfigurasikan pengaturan peluncuran untuk setiap folder root satu per satu untuk men-debug proyek secara terpisah atau bersamaan menggunakan compound.
Pemecahan Masalah Umum launch.json Masalah
Terkadang, proses debug rentan terhadap kumpulan bugnya sendiri. Mari kita lihat beberapa masalah umum dan cara memecahkannya.Kesalahan Validasi
Schema
Kesalahan validasi skema terjadi ketika file launch.json memiliki properti atau nilai yang tidak valid. Untuk memperbaiki kesalahan skema:
Tinjau pesan kesalahan dari panel Masalah.Perbarui file launch.json sesuai dengan informasi dari pesan kesalahan.Kegagalan Debugging
Pengaturan peluncuran yang salah dapat menyebabkan kegagalan debugging.
Periksa konfigurasi peluncuran Anda untuk jalur file yang salah.Verifikasi hilang atau debugger atau jenis permintaan yang salah.Perbarui setelan sesuai kebutuhan.Mendiagnosis Masalah Konfigurasi Peluncuran
Untuk mendiagnosis masalah dengan konfigurasi peluncuran:
Aktifkan pendataan diagnostik dengan menyetel properti "jejak" ke "verbose".Tinjau log yang dihasilkan di Konsol Debug untuk mengidentifikasi dan memperbaiki apa pun masalah.Tips untuk launch.json
Gunakan launch.json secara optimal dengan tips berikut:
Gunakan nama yang bermakna untuk konfigurasi peluncuran agar mudah diidentifikasi. Praktik ini membantu Anda menemukan konfigurasi yang sesuai dengan cepat saat bekerja dengan beberapa skenario debug. Bagikan konfigurasi peluncuran dengan tim Anda dengan menyertakan file launch.json di sistem kontrol versi proyek Anda. Setiap anggota tim dapat mengakses konfigurasi dan pengaturan debug yang sama. Sistem kontrol versi seperti Git dapat melacak perubahan pada file launch.json Anda. Anda dapat menggunakan kontrol versi untuk kembali ke konfigurasi sebelumnya dan berkolaborasi dengan anggota tim lain dengan berbagi pengaturan yang disarankan dengan mereka. Instal ekstensi yang mendukung bahasa, debugger, atau alat tertentu yang sesuai dengan tuntutan proyek. Konfigurasikan file launch.json untuk menggunakan ekstensi ini dan fiturnya selama sesi debug. Luncurkan Ke Debugging
Dengan memanfaatkan kekuatan launch.json, Anda dapat menyesuaikan pengalaman debug agar paling cocok dengan gaya pengkodean Anda. Ini akan meningkatkan kualitas dan kinerja kode Anda.
Seberapa sering Anda harus mengonfigurasi pengaturan peluncuran? Apakah Anda memiliki tip konfigurasi? Silakan bagikan pengalaman Anda di bagian komentar di bawah ini.