Serwery LSP

opencode integruje się z serwerem LSP.

opencode integruje się z protokołem serwera językowego (LSP), aby pomóc LLM w korzystaniu z bazowego kodu. Wykorzystuje diagnostykę, aby otrzymać odpowiedź zwrotną do LLM.

Wbudowany

opencode posiada kilka wbudowanych serwerów LSP dla języków:

Serwer LSP	Rozszerzenie	Wymagania
astro	.astro	Automatyczne instalacje dla Astro
bash	.sh, .bash, .zsh, .ksh	Automatycznie instaluje serwer języka bash
clangd	.c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++	Automatyczne instalacje dla C/C++
csharp	.cs	`.NET SDK` zainstalowany
clojure-lsp	.clj, .cljs, .cljc, .edn	Komenda `clojure-lsp` dostępna
dart	.dart	Komenda `dart` dostępna
deno	.ts, .tsx, .js, .jsx, .mjs	Dostępne rozwiązanie `deno` (automatyczne wykrywanie deno.json/deno.jsonc)
elixir-ls	.ex, .exs	Komenda `elixir` dostępna
eslint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue	`eslint` zależność w projekcie
fsharp	.fs, .fsi, .fsx, .fsscript	`.NET SDK` zainstalowany
gleam	.gleam	Komenda `gleam` dostępna
gopls	.go	Komenda `go` dostępna
hls	.hs, .lhs	Komenda `haskell-language-server-wrapper` dostępna
jdtls	.java	`Java SDK (version 21+)` zainstalowany
kotlin-ls	.kt, .kts	Automatyczne instalacje dla Kotlin
lua-ls	.lua	Automatyczne instalacje dla Lua
nixd	.nix	Komenda `nixd` dostępna
ocaml-lsp	.ml, .mli	Komenda `ocamllsp` dostępna
oxlint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte	`oxlint` zależność w projekcie
php intelephense	.php	Automatyczne instalacje dla PHP
prisma	.prisma	Komenda `prisma` dostępna
pyright	.py, .pyi	Zainstalowana zależność `pyright`
ruby-lsp (rubocop)	.rb, .rake, .gemspec, .ru	Dostępne polecenie `ruby` i `gem`
rust	.rs	Komenda `rust-analyzer` dostępna
sourcekit-lsp	.swift, .objc, .objcpp	`swift` zainstalowany (`xcode` na macOS)
svelte	.svelte	Automatyczne instalacje dla aplikacji Svelte
terraform	.tf, .tfvars	Automatyczne instalacje z wydań GitHub
tinymist	.typ, .typc	Automatyczne instalacje z wydań GitHub
typescript	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts	`typescript` zależność w projekcie
vue	.vue	Automatyczne instalacje dla Vue
yaml-ls	.yaml, .yml	Automatycznie instaluje serwer języka yaml Red Hat
zls	.zig, .zon	Komenda `zig` dostępna

Serwery LSP są automatycznie włączane po wykryciu jednego z rozszerzonych plików i wymagań.

Jak to działa

Gdy opencode otwiera plik, to:

Sprawdzanie pliku na wszystkich dostępnych serwerach LSP.
Uruchamia właściwy serwer LSP, jeśli jeszcze nie działa.

Skonfiguruj

Możesz dostosować serwery LSP poprzez sekcję lsp w konfiguracji opencode.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {}
}

Każdy serwer LSP obsługuje szczegółowe elementy:

Nieruchomość	Wpisz	Opis
`disabled`	boolean	Ustaw tę opcję na `true`, aby wyłączyć serwer LSP
`command`	string[]	Polecenie uruchomienia serwera LSP
`extensions`	string[]	Rozszerzenia plików, które powinny mieć ten serwer LSP
`env`	object	Zmienne ustawienia podczas uruchamiania serwera
`initialization`	object	Opcje inicjalizacji do wysłania na serwer LSP

Spójrzmy na kilka przykładów.

Zmienne środowiskowe

Zastosowanie env, aby ustawić zmienne parametry transmisji podczas uruchamiania serwera LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opcje inicjalizacji

właściwości initialization, aby mieć możliwość inicjalizacji na serwerze LSP. Są to ustawienia dla serwera wysyłającego podczas przełączania LSP initialize:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

Wyłączanie serwerów LSP

Aby wyłączyć wszystkie serwery LSP globalnie, ustaw lsp na false:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}

Aby wyłączyć określony serwer LSP, ustawa disabled na true:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "disabled": true
    }
  }
}

Niestandardowe serwery LSP

Serwer udostępniający serwery LSP, mechanizmy sterujące i udostępniane pliki:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"]
    }
  }
}

Dodatkowe informacje

PHP Intelefense

PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz przechowywać klucz licencyjny umieszczając (tylko) klucz w pliku tekstowym pod adresem:

W systemie macOS/Linux: $HOME/intelephense/license.txt
W systemie Windows: %USERPROFILE%/intelephense/license.txt

Plik powinien zawierać wyłącznie klucz licencyjny, bez udostępniania treści.