LSP 服务器

OpenCode 与你的 LSP 服务器集成。

OpenCode 可以与你的 Language Server Protocol (LSP) 集成，帮助 LLM 与你的代码库交互。它通过诊断信息向 LLM 提供反馈。

内置

OpenCode 为流行的语言内置了若干 LSP 服务器：

启用 LSP 后，当检测到上述某个文件扩展名且满足相应要求时，对应的服务器就会启动。

注意： 你可以通过将 OPENCODE_DISABLE_LSP_DOWNLOAD 环境变量设置为 true 来禁用 LSP 服务器的自动下载。

工作原理

当启用了 LSP 且 opencode 打开一个文件时，它会：

1. 将文件扩展名与所有已启用的 LSP 服务器进行比对。
2. 如果对应的 LSP 服务器尚未运行，则启动它。

配置

你可以通过 opencode 配置中的 lsp 部分来启用和自定义 LSP 服务器。

要启用所有内置 LSP 服务器，将 lsp 设置为 true。

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

使用对象，可以在保持内置服务器启用的同时，配置覆盖项或自定义服务器。

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

每个已配置的 LSP 服务器条目支持以下内容：

服务器条目需要 command，除非它们仅用于禁用某个服务器。

我们来看一些示例。

环境变量

使用 env 属性在启动 LSP 服务器时设置环境变量：

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

初始化选项

使用 initialization 属性向 LSP 服务器传递初始化选项。这些是在 LSP initialize 请求期间发送的、特定于服务器的设置：

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

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

该文件应只包含授权密钥，不含任何其他内容。