Serwery LSP

OpenCode integruje się z serwerami LSP.

OpenCode integruje się z protokołem Language Server Protocol (LSP), aby zapewnić modelom LLM kontekst bazy kodu. Wykorzystuje diagnostykę, aby przekazywać informacje zwrotne do LLM.

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+)`
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`

Serwery LSP są automatycznie włączane po wykryciu jednego z obsługiwanych plików i spełnieniu wymagań.

Jak to działa

Gdy OpenCode otwiera plik:

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

Konfiguracja

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

{
  "$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

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, 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.