LSP 服务器

OpenCode 与你的 LSP 服务器集成。

OpenCode 与语言服务器协议 (LSP) 集成，帮助 LLM 与你的代码库交互。它使用诊断信息为 LLM 提供反馈。

内置支持

OpenCode 为流行语言内置了多个 LSP 服务器：

当检测到上述文件扩展名且满足要求时，LSP 服务器会自动启用。

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

工作原理

当 opencode 打开文件时，它会：

1. 检查文件扩展名是否匹配已启用的 LSP 服务器。
2. 如果尚未运行，则启动相应的 LSP 服务器。

配置

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

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

每个 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/licence.txt
• Windows：%USERPROFILE%/intelephense/licence.txt

文件应仅包含许可证密钥，不要有其他内容。