---
title: Serwery LSP
description: 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ń.

:::note
Możesz wyłączyć automatyczne pobieranie serwerów LSP, ustawiając zmienną środowiskową `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`.
:::

---

## Jak to działa

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

1. Sprawdza plik pod kątem wszystkich dostępnych serwerów LSP.
2. 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`.

```json title="opencode.json"
{
  "$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.

```json title="opencode.json"
{
  "$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:

```json title="opencode.json" {5-7}
{
  "$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:

```json title="opencode.json" {5-9}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}
```

:::note
Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź dokumentację swojego serwera LSP.
:::

---

### 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`:

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

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

```json title="opencode.json" {5}
{
  "$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:

```json title="opencode.json" {4-7}
{
  "$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.
