189 lines
9.6 KiB
Plaintext
189 lines
9.6 KiB
Plaintext
---
|
|
title: Servidores LSP
|
|
description: O opencode integra-se aos seus servidores LSP.
|
|
---
|
|
|
|
O opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
|
|
|
|
---
|
|
|
|
## Integrados
|
|
|
|
O opencode vem com vários servidores LSP integrados para linguagens populares:
|
|
|
|
| Servidor LSP | Extensões | Requisitos |
|
|
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
|
|
| astro | .astro | Instala automaticamente para projetos Astro |
|
|
| bash | .sh, .bash, .zsh, .ksh | Instala automaticamente bash-language-server |
|
|
| clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Instala automaticamente para projetos C/C++ |
|
|
| csharp | .cs | `.NET SDK` instalado |
|
|
| clojure-lsp | .clj, .cljs, .cljc, .edn | Comando `clojure-lsp` disponível |
|
|
| dart | .dart | Comando `dart` disponível |
|
|
| deno | .ts, .tsx, .js, .jsx, .mjs | Comando `deno` disponível (detecta automaticamente deno.json/deno.jsonc) |
|
|
| elixir-ls | .ex, .exs | Comando `elixir` disponível |
|
|
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | Dependência `eslint` no projeto |
|
|
| fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` instalado |
|
|
| gleam | .gleam | Comando `gleam` disponível |
|
|
| gopls | .go | Comando `go` disponível |
|
|
| hls | .hs, .lhs | Comando `haskell-language-server-wrapper` disponível |
|
|
| jdtls | .java | `Java SDK (version 21+)` instalado |
|
|
| kotlin-ls | .kt, .kts | Instala automaticamente para projetos Kotlin |
|
|
| lua-ls | .lua | Instala automaticamente para projetos Lua |
|
|
| nixd | .nix | Comando `nixd` disponível |
|
|
| ocaml-lsp | .ml, .mli | Comando `ocamllsp` disponível |
|
|
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dependência `oxlint` no projeto |
|
|
| php intelephense | .php | Instala automaticamente para projetos PHP |
|
|
| prisma | .prisma | Comando `prisma` disponível |
|
|
| pyright | .py, .pyi | Dependência `pyright` instalada |
|
|
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Comandos `ruby` e `gem` disponíveis |
|
|
| rust | .rs | Comando `rust-analyzer` disponível |
|
|
| sourcekit-lsp | .swift, .objc, .objcpp | `swift` instalado (`xcode` no macOS) |
|
|
| svelte | .svelte | Instala automaticamente para projetos Svelte |
|
|
| terraform | .tf, .tfvars | Instala automaticamente a partir de lançamentos do GitHub |
|
|
| tinymist | .typ, .typc | Instala automaticamente a partir de lançamentos do GitHub |
|
|
| typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Dependência `typescript` no projeto |
|
|
| vue | .vue | Instala automaticamente para projetos Vue |
|
|
| yaml-ls | .yaml, .yml | Instala automaticamente o servidor yaml-language-server da Red Hat |
|
|
| zls | .zig, .zon | Comando `zig` disponível |
|
|
|
|
Os servidores LSP são habilitados automaticamente quando uma das extensões de arquivo acima é detectada e os requisitos são atendidos.
|
|
|
|
:::note
|
|
Você pode desabilitar os downloads automáticos do servidor LSP definindo a variável de ambiente `OPENCODE_DISABLE_LSP_DOWNLOAD` como `true`.
|
|
:::
|
|
|
|
---
|
|
|
|
## Como Funciona
|
|
|
|
Quando o opencode abre um arquivo, ele:
|
|
|
|
1. Verifica a extensão do arquivo em relação a todos os servidores LSP habilitados.
|
|
2. Inicia o servidor LSP apropriado se não estiver em execução.
|
|
|
|
---
|
|
|
|
## Configuração
|
|
|
|
Você pode personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode.
|
|
|
|
```json title="opencode.json"
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {}
|
|
}
|
|
```
|
|
|
|
Cada servidor LSP suporta o seguinte:
|
|
|
|
| Propriedade | Tipo | Descrição |
|
|
| ---------------- | -------- | ------------------------------------------------------------- |
|
|
| `disabled` | boolean | Defina como `true` para desabilitar o servidor LSP |
|
|
| `command` | string[] | O comando para iniciar o servidor LSP |
|
|
| `extensions` | string[] | Extensões de arquivo que este servidor LSP deve manipular |
|
|
| `env` | object | Variáveis de ambiente a serem definidas ao iniciar o servidor |
|
|
| `initialization` | object | Opções de inicialização a serem enviadas ao servidor LSP |
|
|
|
|
Vamos ver alguns exemplos.
|
|
|
|
---
|
|
|
|
### Variáveis de ambiente
|
|
|
|
Use a propriedade `env` para definir variáveis de ambiente ao iniciar o servidor LSP:
|
|
|
|
```json title="opencode.json" {5-7}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"rust": {
|
|
"env": {
|
|
"RUST_LOG": "debug"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Opções de inicialização
|
|
|
|
Use a propriedade `initialization` para passar opções de inicialização ao servidor LSP. Estas são configurações específicas do servidor enviadas durante a solicitação `initialize` do LSP:
|
|
|
|
```json title="opencode.json" {5-9}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"typescript": {
|
|
"initialization": {
|
|
"preferences": {
|
|
"importModuleSpecifierPreference": "relative"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
:::note
|
|
As opções de inicialização variam de acordo com o servidor LSP. Verifique a documentação do seu servidor LSP para opções disponíveis.
|
|
:::
|
|
|
|
---
|
|
|
|
### Desabilitando servidores LSP
|
|
|
|
Para desabilitar **todos** os servidores LSP globalmente, defina `lsp` como `false`:
|
|
|
|
```json title="opencode.json" {3}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": false
|
|
}
|
|
```
|
|
|
|
Para desabilitar um servidor LSP **específico**, defina `disabled` como `true`:
|
|
|
|
```json title="opencode.json" {5}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"typescript": {
|
|
"disabled": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Servidores LSP personalizados
|
|
|
|
Você pode adicionar servidores LSP personalizados especificando o comando e as extensões de arquivo:
|
|
|
|
```json title="opencode.json" {4-7}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"custom-lsp": {
|
|
"command": ["custom-lsp-server", "--stdio"],
|
|
"extensions": [".custom"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Informações Adicionais
|
|
|
|
### PHP Intelephense
|
|
|
|
PHP Intelephense oferece recursos premium através de uma chave de licença. Você pode fornecer uma chave de licença colocando (apenas) a chave em um arquivo de texto em:
|
|
|
|
- No macOS/Linux: `$HOME/intelephense/license.txt`
|
|
- No Windows: `%USERPROFILE%/intelephense/license.txt`
|
|
|
|
O arquivo deve conter apenas a chave de licença sem conteúdo adicional.
|