File size: 14,148 Bytes
0dbc9de | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 | ---
title: LSP-серверы
description: 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 отключен по умолчанию. Когда он включен, серверы запускаются при обнаружении одного из указанных выше расширений файлов и выполнении требований.
:::note
Вы можете отключить автоматическую загрузку LSP-сервера, установив для переменной среды `OPENCODE_DISABLE_LSP_DOWNLOAD` значение `true`.
:::
---
## Как это работает
Когда LSP включен и opencode открывает файл, он:
1. Проверяет расширение файла на всех включенных серверах LSP.
2. Запускает соответствующий сервер LSP, если он еще не запущен.
---
## Рекомендации
LSP может помочь агенту находить и исправлять проблемы, предоставляя диагностику от языковых серверов. Это полезно в некоторых проектах, но не всегда является однозначным преимуществом.
Языковые серверы могут рассинхронизироваться, потреблять много памяти, отличаться по поведению между версиями или проектами и замедлять рабочие процессы агента. Во многих проектах лучше, чтобы агент напрямую запускал lint, typecheck или другие диагностические CLI-инструменты; так ошибки возвращаются в цикл агента без этих компромиссов. Задокументируйте эти команды в файлах инструкций, например `AGENTS.md` или skills, чтобы агент знал, что запускать. Включайте LSP, когда проект получает пользу от дополнительной обратной связи языкового сервера.
---
## Настройка
Вы можете включить и настроить серверы LSP через раздел `lsp` в конфигурации opencode.
Чтобы включить все встроенные LSP-серверы, установите `lsp` в `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Используйте объект, чтобы оставить встроенные серверы включенными и при этом настроить переопределения или пользовательские серверы.
```json title="opencode.json"
{
"$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:
```json title="opencode.json" {5-7}
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"rust": {
"env": {
"RUST_LOG": "debug"
}
}
}
}
```
---
### Параметры инициализации
Используйте свойство `initialization` для передачи параметров инициализации на LSP-сервер. Это настройки, специфичные для сервера, отправляемые во время запроса LSP `initialize`:
```json title="opencode.json" {5-9}
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"typescript": {
"initialization": {
"preferences": {
"importModuleSpecifierPreference": "relative"
}
}
}
}
}
```
:::note
Параметры инициализации зависят от сервера LSP. Проверьте документацию вашего LSP-сервера на наличие доступных опций.
:::
---
### Отключение LSP-серверов
Если `lsp` не указан, все LSP-серверы отключены. Чтобы отключить все LSP-серверы после того, как другая конфигурация их включила, установите для `lsp` значение `false`:
```json title="opencode.json" {3}
{
"$schema": "https://opencode.ai/config.json",
"lsp": false
}
```
Чтобы отключить **конкретный** LSP-сервер, установите для `disabled` значение `true`:
```json title="opencode.json" {5}
{
"$schema": "https://opencode.ai/config.json",
"lsp": {
"typescript": {
"disabled": true
}
}
}
```
---
### Пользовательские LSP-серверы
Вы можете добавить собственные LSP-серверы, указав команду и расширения файлов:
```json title="opencode.json" {4-7}
{
"$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`
Файл должен содержать только лицензионный ключ без какого-либо дополнительного содержимого.
|