Diagnostik LSP — Kode Diperiksa Saat Anda Mengetik

Bayangkan sebuah pemeriksa ejaan untuk tulisanmu, tetapi untuk kode — itulah LSP Diagnostics.

Apa Itu LSP, Sebenarnya?

LSP adalah singkatan dari Language Server Protocol. Ini adalah pembantu di balik layar yang diajak bicara oleh editor kode-mu. Saat kamu mengetik, editor mengirim kode-mu ke language server, yang memeriksa kesalahan dan mengirimkan saran kembali. Kamu melihat hasilnya sebagai garis bawah merah bergelombang, peringatan kuning, atau ikon bola lampu kecil.

Di Hermes Agent, kami menggunakan LSP untuk memberimu umpan balik instan saat kamu menulis — tanpa perlu menjalankan perintah “periksa” terpisah. Ini seperti memiliki seorang developer senior yang sabar mengintip dari balik bahumu, menunjukkan kesalahan ketik dan kekeliruan logika sebelum kamu bahkan menyimpan file.

Mengapa Pemula Harus Peduli?

Kamu tidak perlu tahu bagaimana LSP bekerja secara internal. Tetapi kamu perlu tahu bahwa:

Ini menangkap kesalahan sederhana (kurung hilang, nama variabel salah) secara langsung.
Ini mengajarkanmu sambil berjalan — arahkan kursor ke garis bergelombang untuk melihat masalah dan perbaikannya.
Ini menghemat waktu — kamu memperbaiki masalah saat masih segar, bukan setelah sesi debugging yang panjang.

Cara Menggunakan LSP Diagnostics di Hermes Agent

Hermes Agent sudah dilengkapi dengan dukungan LSP bawaan. Berikut cara memulainya:

1. Buka Proyekmu

Pastikan kamu berada di folder dengan kode-mu. Di terminal:

cd my-project

2. Mulai Integrasi Editor Hermes Agent

Jalankan perintah ini (atau gunakan pintasan di editor-mu):

hermes lsp start

Sekarang, buka file .py, .js, .ts, atau .go apa pun. Kamu akan melihat diagnostik muncul secara otomatis.

3. Baca Panel Diagnostik

Di sebagian besar editor, tekan:

Ctrl+Shift+M   (Windows/Linux)
Cmd+Shift+M    (Mac)

Ini membuka panel “Problems”. Panel ini mencantumkan setiap masalah, dengan nama file, nomor baris, dan deskripsi singkat.

4. Terapkan Perbaikan Cepat

Klik pada garis bergelombang. Popup kecil akan muncul. Pilih “Quick Fix” atau tekan:

Ctrl+.   (Windows/Linux)
Cmd+.    (Mac)

Hermes Agent akan menyarankan perbaikan — seringkali hanya satu ketukan tombol untuk menerimanya.

Apa Arti Simbol-Simbol Itu?

Garis bawah merah = kesalahan. Sesuatu pasti salah (misalnya, fungsi yang tidak terdefinisi).
Garis bawah kuning = peringatan. Tidak fatal, tetapi kemungkinan besar bug (misalnya, variabel yang tidak digunakan).
Biru/bola lampu = saran. Peningkatan opsional (misalnya, sederhanakan kode ini).

Contoh Nyata

Katakanlah kamu mengetik ini di Python:

def greet(name):
    print("Hello, " + nam)

Perhatikan nam — sebuah kesalahan ketik. LSP akan menggarisbawahinya dengan warna merah. Arahkan kursor ke atasnya, dan kamu akan melihat:

Nama "nam" tidak terdefinisi. Apakah yang kamu maksud adalah "name"?

Klik perbaikan cepat, dan itu akan berubah menjadi name secara otomatis. Kamu baru saja menghindari crash.

Kesalahan Umum (Dan Cara Menghindarinya)

Jangan abaikan peringatan — seringkali itu menunjuk pada bug di masa depan.
Periksa panel secara teratur — bukan hanya baris saat ini.
Jika kamu melihat “Tidak ada server LSP yang ditemukan” — pastikan kamu menjalankan hermes lsp start dan jenis file-mu didukung.

Ringkasan dan Tips Praktis

LSP Diagnostics memberimu umpan balik waktu nyata, membuat coding terasa lebih seperti percakapan daripada permainan menebak. Kamu menulis, alat memberi kode, kamu memperbaiki — sesederhana itu.

Tips praktis: Sebelum menjalankan kode-mu, selalu lihat panel Problems. Satu pandangan cepat bisa menghemat sepuluh menit debugging “Kenapa ini rusak?”. Jadikan itu kebiasaan — dirimu di masa depan akan berterima kasih.

Sekarang pergilah menulis kode, dan biarkan garis-garis bergelombang itu membimbingmu.