Serwery LSP

OpenCode integruje się z serwerami LSP.

OpenCode może integrować się z serwerami Language Server Protocol (LSP), aby używać diagnostyki jako informacji zwrotnej dla agenta.

Wbudowane

OpenCode posiada kilka wbudowanych serwerów LSP dla następujących języków:

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

LSP jest domyślnie wyłączone. Gdy jest włączone, serwery uruchamiają się po wykryciu jednego z obsługiwanych rozszerzeń plików i spełnieniu wymagań.

Jak to działa

Gdy LSP jest włączony i OpenCode otwiera plik:

Sprawdza plik pod kątem wszystkich dostępnych serwerów LSP.
Uruchamia odpowiedni serwer LSP, jeśli jeszcze nie działa.

Dobre praktyki

LSP może pomóc agentowi znajdować i naprawiać problemy, dostarczając diagnostykę z serwerów językowych. Jest to przydatne w niektórych projektach, ale nie zawsze jest jednoznaczną korzyścią.

Serwery językowe mogą wypaść z synchronizacji, zużywać dużo pamięci, różnić się między wersjami lub projektami i spowalniać workflow agenta. W wielu projektach lepiej, aby agent uruchamiał lint, typecheck lub inne diagnostyczne narzędzia CLI bezpośrednio; wtedy błędy wracają do pętli agenta bez tych kompromisów. Udokumentuj te komendy w plikach instrukcji, takich jak AGENTS.md lub skills, aby agent wiedział, co uruchomić. Włącz LSP, gdy Twój projekt korzysta z dodatkowej informacji zwrotnej z serwera językowego.

Konfiguracja

Możesz włączać i dostosowywać serwery LSP poprzez sekcję lsp w konfiguracji OpenCode.

Aby włączyć wszystkie wbudowane serwery LSP, ustaw lsp na true.

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

Użyj obiektu, aby pozostawić wbudowane serwery włączone i jednocześnie skonfigurować nadpisania lub serwery niestandardowe.

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

Każdy serwer LSP obsługuje następujące właściwości:

Właściwość	Typ	Opis
`disabled`	boolean	Ustaw na `true`, aby wyłączyć ten serwer LSP
`command`	string[]	Polecenie uruchomienia serwera LSP
`extensions`	string[]	Rozszerzenia plików, które powinny używać tego serwera
`env`	object	Zmienne środowiskowe ustawiane podczas uruchamiania
`initialization`	object	Opcje inicjalizacji do wysłania do serwera LSP

Spójrzmy na kilka przykładów.

Zmienne środowiskowe

Użyj env, aby ustawić zmienne środowiskowe podczas uruchamiania serwera LSP:

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

Opcje inicjalizacji

Użyj właściwości initialization, aby przekazać niestandardowe opcje inicjalizacji do serwera LSP. Są one wysyłane w żądaniu initialize protokołu LSP:

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

Wyłączanie serwerów LSP

Jeśli lsp zostanie pominięte, wszystkie serwery LSP są wyłączone. Aby wyłączyć wszystkie serwery LSP po tym, jak inna konfiguracja je włączyła, ustaw lsp na false:

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

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

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

Niestandardowe serwery LSP

Możesz dodać niestandardowe serwery LSP, podając polecenie i rozszerzenia plików:

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

Dodatkowe informacje

PHP Intelephense

PHP Intelephense oferuje funkcje premium poprzez klucz licencyjny. Możesz użyć klucza licencyjnego, umieszczając go (sam klucz) w pliku tekstowym pod adresem:

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

Plik powinien zawierać wyłącznie klucz licencyjny, bez białych znaków.