nvim lspconfig

nvim-lspconfig

nvim-lspconfig는 다양한 LSP 서버에 대한 기본 기본 Nvim LSP 클라이언트 구성을 제공하는 "데이터 전용" 저장소입니다.

모든 구성에 대한 설명서를 보거나 Nvim에서 :help lspconfig-all 확인하세요.

중요한 ⚠️

• Nvim LSP 기능( :help lsp )에서 버그를 발견한 경우 Neovim 코어에 보고하세요.
  • 여기에 신고 하지 마세요 . 여기에는 구성 데이터만 있습니다.
• 이러한 구성은 최선의 노력을 다한 것이며 커뮤니티에서 지원됩니다. 기여를 참조하세요.
• 참고: 이 저장소는 구성 만 제공합니다. 프로그래밍 방식 API는 더 이상 사용되지 않으며 외부에서 사용해서는 안 됩니다.
  • nvim-lspconfig의 "프레임워크" 부분(구성 아님 )을 선택적으로 Nvim 코어로 업스트림하고 nvim-lspconfig에서 더 이상 사용하지 않는 작업이 계획되어 있습니다.

설치하다

• 위의 Nvim 0.9가 필요합니다. 문제를 보고하기 전에 Nvim 및 nvim-lspconfig를 업데이트하세요.
• Vim의 "패키지" 기능을 사용하여 nvim-lspconfig를 설치하세요:

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

• 또는 타사 플러그인 관리자를 사용하세요(플러그인 관리자 설명서 참조).

빠른 시작

1. 언어 서버 설치(예: pyright)

   npm i -g pyright

2. init.lua에 언어 서버 설정을 추가하세요.

    require ' lspconfig ' . pyright . setup {}

3. 프로젝트/작업공간에 :help lspconfig-all 에 지정된 서버 요구 사항과 일치하는 루트 마커가 포함되어 있는지 확인하세요.
4. Nvim에서 코드 파일을 엽니다. LSP가 연결되어 진단을 제공합니다.

    nvim main.py
   

5. 상태를 확인하거나 문제를 해결하려면 :checkhealth lsp 실행하세요.

자세한 내용은 :help lspconfig 참조하세요. 서버별 세부 정보 전체 목록을 보려면 :help lspconfig-all 읽어보세요. $PATH 에 없는 서버(예: jdtls , elixirls )의 경우 setup() 호출할 때 cmd 매개변수를 수동으로 설정해야 합니다.

구성

Nvim은 버퍼가 LSP에 연결될 때 몇 가지 기본 옵션과 매핑을 설정합니다( :help lsp-config 참조). 특히:

• 'tagfunc'
  • <C-]> 및 기타 태그 명령을 사용하여 "정의로 이동" 기능을 활성화합니다.
• 'omnifunc'
  • 삽입 모드에서 <CX><CO> 를 사용하여 (수동) 옴니 모드 완료를 활성화합니다. 자동 완성을 위해서는 자동완성 플러그인이 필요합니다.
• 'formatexpr'
  • gq 사용하여 LSP 형식을 활성화합니다.
• K 일반 모드에서 vim.lsp.buf.hover() 에 매핑됩니다.
• [d 및 ]d 각각 vim.diagnostic.goto_prev() 및 vim.diagnostic.goto_next() 에 매핑됩니다.
• <CW>d vim.diagnostic.open_float() 에 매핑됩니다.

LspAttach 자동 명령 이벤트를 사용하여 추가 사용자 정의를 수행할 수 있습니다. LspDetach 자동 명령 이벤트는 버퍼가 LSP 서버에서 분리되는 경우 매핑을 "정리"하는 데 사용할 수 있습니다. 자세한 내용과 예는 :h LspAttach 및 :h LspDetach 참조하세요. 다른 LSP 기능에 대한 자세한 내용은 :h lsp-buf 참조하세요.

setup 함수에 인수를 전달하여 각 LSP 서버에 추가 구성 옵션을 제공할 수 있습니다. 자세한 내용은 :h lspconfig-setup 참조하세요. 예:

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

문제 해결

언어 서버가 시작되지 않거나 연결되지 않는 가장 일반적인 이유는 다음과 같습니다.

1. 언어 서버가 설치되지 않았습니다. nvim-lspconfig는 언어 서버를 설치하지 않습니다. 명령줄에서 각 서버의 Lua 모듈에 정의된 cmd 실행하고 언어 서버가 시작되는지 확인할 수 있어야 합니다. cmd 실행 파일의 절대 경로가 아닌 실행 파일 이름인 경우 경로에 있는지 확인하세요.
2. 파일 형식 플러그인이 없습니다. 특정 언어는 아직 파일 형식 감지 시스템에 추가되지 않았기 때문에 Vim/Nvim에서 감지하지 못합니다. :set ft? 확인하세요. 빈 값이 아닌 파일 형식을 표시합니다.
3. 루트 감지를 트리거하지 않습니다. 일부 언어 서버는 프로젝트의 루트를 나타내는 파일이 포함된 디렉터리 또는 하위 디렉터리에서 열리는 경우에만 시작됩니다. 대부분의 경우 이는 .git 폴더이지만 각 서버는 lua 파일에 루트 구성을 정의합니다. 루트 디렉터리 목록은 doc/configs.md 또는 소스를 참조하세요.
4. 이를 적용하려면 각 setup {} 에 대한 capabilities 전달해야 합니다. {}
5. 동일한 서버에 대해 setup {} 두 번 호출하지 마십시오 . setup {} 에 대한 두 번째 호출은 첫 번째 호출을 덮어씁니다.

버그 신고

LSP 기능에서 버그를 발견한 경우 Neovim core에 보고하세요.

버그를 보고하기 전에 로그와 :LspInfo 출력을 확인하세요. 로깅을 활성화하려면 init.vim에 다음을 추가하세요:

 vim . lsp . set_log_level ( " debug " )

언어 서버를 실행하고 다음을 사용하여 로그를 엽니다.

 :LspLog

대부분의 경우 실패 이유는 로그에 나와 있습니다.

명령

• :LspInfo ( :che lspconfig 에 대한 더 이상 사용되지 않는 별칭)는 활성 및 구성된 언어 서버의 상태를 표시합니다.
• :LspStart <config_name> 요청한 서버 이름을 시작합니다. 명령이 현재 구성과 일치하는 루트 디렉터리를 감지한 경우에만 성공적으로 시작됩니다. 이 명령만으로 클라이언트를 시작하려면 언어 서버에 대한 .setup{} 호출에 autostart = false 전달하세요. 현재 버퍼 파일 유형과 일치하는 모든 서버가 기본값입니다.
• :LspStop <client_id> 기본값은 모든 버퍼 클라이언트를 중지하는 것입니다.
• :LspRestart <client_id> 기본값은 모든 버퍼 클라이언트를 다시 시작하는 것입니다.

기여

configs.md에 언어 서버가 없는 경우, 이에 대한 새 구성을 제공하면 특히 서버에 특별한 설정이 필요한 경우 다른 사람에게 도움이 됩니다. 다음 단계를 따르세요.

1. CONTRIBUTING.md를 읽어보세요.
2. lua/lspconfig/configs/SERVER_NAME.lua 에 새 파일을 만듭니다.
   • 시작하려면 기존 구성을 복사하세요. 대부분의 구성은 간단합니다. 광범위한 예를 보려면 texlab.lua를 참조하세요.
3. GitHub 토론이나 Neovim Matrix 룸에 질문하세요.

출시 과정

릴리스를 게시하려면 다음을 수행하십시오.

• 새 태그를 생성하고 푸시합니다.
• 태그를 푸시한 후 GitHub 작업이 자동으로 플러그인을 패키징하고 LuaRocks에 릴리스를 게시합니다.

특허

저작권 Neovim 기여자. 모든 권리 보유.

nvim-lspconfig는 Apache 2.0 라이선스 조건에 따라 라이선스가 부여됩니다.

LICENSE.md를 참조하세요.