LSP-серверы

OpenCode интегрируется с вашими LSP-серверами.

OpenCode может интегрироваться с вашим Language Server Protocol (LSP), чтобы помочь LLM взаимодействовать с вашей кодовой базой. Он использует диагностику для предоставления обратной связи LLM.

Встроенные

OpenCode поставляется с несколькими встроенными LSP-серверами для популярных языков:

LSP-сервер	Расширения	Требования
astro	.astro	Автоустановка для проектов Astro
bash	.sh, .bash, .zsh, .ksh	Автоустановка bash-language-server
clangd	.c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++	Автоустановка для проектов C/C++
csharp	.cs, .csx	Установлен `.NET SDK`
clojure-lsp	.clj, .cljs, .cljc, .edn	Доступна команда `clojure-lsp`
dart	.dart	Доступна команда `dart`
deno	.ts, .tsx, .js, .jsx, .mjs	Доступна команда `deno` (автоопределение deno.json/deno.jsonc)
elixir-ls	.ex, .exs	Доступна команда `elixir`
eslint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue	Зависимость `eslint` в проекте
fsharp	.fs, .fsi, .fsx, .fsscript	Установлен `.NET SDK`
gleam	.gleam	Доступна команда `gleam`
gopls	.go	Доступна команда `go`
hls	.hs, .lhs	Доступна команда `haskell-language-server-wrapper`
jdtls	.java	Установлен `Java SDK (версия 21+)`
julials	.jl	Установлены `julia` и `LanguageServer.jl`
kotlin-ls	.kt, .kts	Автоустановка для проектов Kotlin
lua-ls	.lua	Автоустановка для проектов Lua
nixd	.nix	Доступна команда `nixd`
ocaml-lsp	.ml, .mli	Доступна команда `ocamllsp`
oxlint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte	Зависимость `oxlint` в проекте
php intelephense	.php	Автоустановка для проектов PHP
prisma	.prisma	Доступна команда `prisma`
pyright	.py, .pyi	Установлена зависимость `pyright`
razor	.razor, .cshtml	Установлены `.NET SDK` и расширение C# для VS Code
ruby-lsp (rubocop)	.rb, .rake, .gemspec, .ru	Доступны команды `ruby` и `gem`
rust	.rs	Доступна команда `rust-analyzer`
sourcekit-lsp	.swift, .objc, .objcpp	Установлен `swift` (`xcode` на macOS)
svelte	.svelte	Автоустановка для проектов Svelte
terraform	.tf, .tfvars	Автоустановка из GitHub releases
tinymist	.typ, .typc	Автоустановка из GitHub releases
typescript	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts	Зависимость `typescript` в проекте
vue	.vue	Автоустановка для проектов Vue
yaml-ls	.yaml, .yml	Автоустановка Red Hat yaml-language-server
zls	.zig, .zon	Доступна команда `zig`

Когда LSP включён, серверы запускаются при обнаружении одного из вышеуказанных расширений файлов и выполнении требований.

Примечание: Вы можете отключить автоматическую загрузку LSP-серверов, установив переменную окружения OPENCODE_DISABLE_LSP_DOWNLOAD в true.

Как это работает

Когда LSP включён и opencode открывает файл, он:

Проверяет расширение файла по всем включённым LSP-серверам.
Запускает соответствующий LSP-сервер, если он ещё не запущен.

Конфигурация

Вы можете включать и настраивать LSP-серверы через раздел lsp в конфигурации opencode.

Чтобы включить все встроенные LSP-серверы, установите lsp в true.

opencode.json

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

Используйте объект, чтобы оставить встроенные серверы включёнными при настройке переопределений или пользовательских серверов.

opencode.json

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

Каждая запись настроенного LSP-сервера поддерживает следующее:

Записям сервера нужен command, если только они не просто отключают сервер.

Свойство	Тип	Описание
`disabled`	boolean	Установите `true` для отключения LSP-сервера
`command`	string[]	Команда для запуска LSP-сервера
`extensions`	string[]	Расширения файлов, которые должен обрабатывать этот LSP-сервер
`env`	object	Переменные окружения, устанавливаемые при запуске сервера
`initialization`	object	Параметры инициализации для отправки LSP-серверу

Рассмотрим несколько примеров.

Переменные окружения

Используйте свойство env для установки переменных окружения при запуске LSP-сервера:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "command": ["rust-analyzer"],
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Параметры инициализации

Используйте свойство initialization для передачи параметров инициализации LSP-серверу. Это специфичные для сервера настройки, отправляемые во время запроса LSP initialize:

opencode.json

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

Примечание: Параметры инициализации различаются в зависимости от LSP-сервера. Проверьте документацию вашего LSP-сервера для доступных параметров.

Отключение LSP-серверов

Если lsp опущен, все LSP-серверы отключены. Чтобы отключить все LSP-серверы после того, как другая конфигурация их включила, установите lsp в false:

opencode.json

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

Чтобы отключить конкретный LSP-сервер, установите disabled в true:

opencode.json

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

Пользовательские LSP-серверы

Вы можете добавить пользовательские LSP-серверы, указав команду и расширения файлов:

opencode.json

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

Дополнительная информация

PHP Intelephense

PHP Intelephense предлагает премиум-функции через лицензионный ключ. Вы можете предоставить лицензионный ключ, поместив (только) ключ в текстовый файл по адресу:

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

Файл должен содержать только лицензионный ключ без дополнительного содержимого.

Разрешения MCP серверы