nvim lspconfig Unduh - nvim lspconfig Unduh kode sumber

nvim lspconfig

Kode sumber lainnya

1.0.0

Unduh

nvim-lspconfig

nvim-lspconfig adalah repo "hanya data", yang menyediakan konfigurasi klien Nvim LSP dasar dan default untuk berbagai server LSP.

Lihat dokumentasi untuk semua konfigurasi atau :help lspconfig-all dari Nvim.

Penting ⚠️

Jika Anda menemukan bug dalam fungsionalitas Nvim LSP ( :help lsp ), laporkan ke inti Neovim.
- Jangan laporkan di sini. Hanya data konfigurasi yang ada di sini.
Konfigurasi ini merupakan upaya terbaik dan didukung oleh komunitas. Lihat kontribusi.
Catatan: Repo ini hanya menyediakan konfigurasi . API terprogramnya tidak digunakan lagi dan tidak boleh digunakan secara eksternal.
- Pekerjaan direncanakan untuk secara selektif melakukan upstream bagian "kerangka kerja" ( bukan konfigurasi) dari nvim-lspconfig, ke inti Nvim, dan menghentikannya di nvim-lspconfig.

Memasang

Membutuhkan Nvim 0.9 di atas. Perbarui Nvim dan nvim-lspconfig sebelum melaporkan masalah.

Instal nvim-lspconfig menggunakan fitur "paket" Vim:

 git clone https://github.com/neovim/nvim-lspconfig ~/.config/nvim/pack/nvim/start/nvim-lspconfig

Atau gunakan pengelola plugin pihak ketiga (lihat dokumentasi untuk pengelola plugin Anda).

Mulai cepat

Instal server bahasa, misalnya pyright
```
npm i -g pyright
```

Tambahkan pengaturan server bahasa ke init.lua Anda.

 require ' lspconfig ' . pyright . setup {}

Pastikan proyek/ruang kerja Anda berisi penanda akar yang sesuai dengan persyaratan server yang ditentukan di :help lspconfig-all .
Buka file kode di Nvim. LSP akan melampirkan dan memberikan diagnosa.
```
 nvim main.py
```
Jalankan :checkhealth lsp untuk melihat status atau memecahkan masalah.

Baca :help lspconfig untuk detailnya. Baca :help lspconfig-all untuk daftar lengkap detail khusus server. Untuk server yang tidak ada di $PATH Anda (misalnya jdtls , elixirls ), Anda harus menyetel parameter cmd secara manual saat memanggil setup() .

Konfigurasi

Nvim menetapkan beberapa opsi dan pemetaan default ketika buffer terpasang ke LSP (lihat :help lsp-config ). Secara khusus:

'tagfunc'
- Mengaktifkan kemampuan "buka definisi" menggunakan <C-]> dan perintah tag lainnya.
'omnifunc'
- Mengaktifkan penyelesaian mode omni (manual) dengan <CX><CO> dalam mode Sisipkan. Untuk penyelesaian otomatis , diperlukan plugin pelengkapan otomatis.
'formatexpr'
- Mengaktifkan pemformatan LSP dengan gq .
K dipetakan ke vim.lsp.buf.hover() dalam mode Normal.
[d dan ]d dipetakan ke vim.diagnostic.goto_prev() dan vim.diagnostic.goto_next() , masing-masing.
<CW>d dipetakan ke vim.diagnostic.open_float() .

Kustomisasi lebih lanjut dapat dicapai dengan menggunakan acara perintah otomatis LspAttach . Peristiwa perintah otomatis LspDetach dapat digunakan untuk "membersihkan" pemetaan jika buffer terlepas dari server LSP. Lihat :h LspAttach dan :h LspDetach untuk detail dan contoh. Lihat :h lsp-buf untuk detail tentang fungsi LSP lainnya.

Opsi konfigurasi tambahan dapat diberikan untuk setiap server LSP dengan meneruskan argumen ke fungsi setup . Lihat :h lspconfig-setup untuk detailnya. Contoh:

 local lspconfig = require ( ' lspconfig ' )
lspconfig . rust_analyzer . setup {
  -- Server-specific settings. See `:help lspconfig-setup`
  settings = {
    [ ' rust-analyzer ' ] = {},
  },
}

Pemecahan masalah

Alasan paling umum mengapa server bahasa tidak memulai atau terhubung adalah:

Server bahasa tidak diinstal. nvim-lspconfig tidak menginstal server bahasa untuk Anda. Anda harus dapat menjalankan cmd yang ditentukan di setiap modul Lua server dari baris perintah dan melihat bahwa server bahasa dimulai. Jika cmd adalah nama yang dapat dieksekusi dan bukan jalur absolut ke file yang dapat dieksekusi, pastikan nama tersebut ada di jalur Anda.
Plugin tipe file tidak ada. Bahasa tertentu tidak terdeteksi oleh Vim/Nvim karena belum ditambahkan ke sistem deteksi tipe file. Pastikan :set ft? menunjukkan tipe file dan bukan nilai kosong.
Tidak memicu deteksi root. Beberapa server bahasa hanya akan mulai jika dibuka di direktori, atau direktori anak, yang berisi file yang menandakan akar proyek. Biasanya, ini adalah folder .git , tetapi setiap server mendefinisikan konfigurasi root dalam file lua. Lihat doc/configs.md atau sumber untuk daftar direktori root.
Anda harus meneruskan capabilities untuk setiap setup {} jika ingin hal ini diterapkan.
Jangan panggil setup {} dua kali untuk server yang sama . Panggilan kedua untuk setup {} akan menimpa panggilan pertama.

Laporan bug

Jika Anda menemukan bug dengan fungsionalitas LSP, laporkan ke inti Neovim.

Sebelum melaporkan bug, periksa log Anda dan keluaran :LspInfo . Tambahkan yang berikut ini ke init.vim Anda untuk mengaktifkan logging:

 vim . lsp . set_log_level ( " debug " )

Coba jalankan server bahasa, dan buka log dengan:

 :LspLog

Seringkali, alasan kegagalan ada di log.

Perintah

:LspInfo (alias yang tidak digunakan lagi :che lspconfig ) menunjukkan status server bahasa yang aktif dan dikonfigurasi.
:LspStart <config_name> Mulai nama server yang diminta. Hanya akan berhasil dimulai jika perintah mendeteksi direktori root yang cocok dengan konfigurasi saat ini. Teruskan autostart = false ke panggilan .setup{} Anda untuk server bahasa jika Anda ingin meluncurkan klien hanya dengan perintah ini. Default untuk semua server yang cocok dengan tipe file buffer saat ini.
:LspStop <client_id> Defaultnya adalah menghentikan semua klien buffer.
:LspRestart <client_id> Defaultnya adalah memulai ulang semua klien buffer.

Kontribusi

Jika server bahasa hilang dari configs.md, menyumbangkan konfigurasi baru untuk itu akan membantu orang lain, terutama jika server memerlukan pengaturan khusus. Ikuti langkah-langkah berikut:

Baca KONTRIBUSI.md.
Buat file baru di lua/lspconfig/configs/SERVER_NAME.lua .
- Salin konfigurasi yang ada untuk memulai. Kebanyakan konfigurasinya sederhana. Untuk contoh ekstensif lihat texlab.lua.
Ajukan pertanyaan di Diskusi GitHub atau di ruang Neovim Matrix.