LSP-серверы

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

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

Встроенные

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

LSP Server	Extensions	Requirements
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	`.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 (version 21+)` установлен
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` зависимость установлена
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
tinymist	.typ, .typc	Автоматически устанавливается из релизов GitHub
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 открывает файл, он:

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

Настройка

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

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

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

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

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

Каждый LSP-сервер поддерживает следующее:

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

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

Переменные среды

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

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

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

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

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

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

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

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

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

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

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

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

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

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