mirror of
https://github.com/anomalyco/opencode.git
synced 2026-04-30 09:46:35 +00:00
189 lines
8.5 KiB
Plaintext
189 lines
8.5 KiB
Plaintext
---
|
||
title: LSP服务器
|
||
description: OpenCode 与您的 LSP 服务器集成。
|
||
---
|
||
|
||
OpenCode 与您的语言服务器协议 (LSP) 集成，以帮助 LLM 与您的代码库交互。它使用诊断向法学硕士提供反馈。
|
||
|
||
---
|
||
|
||
## 內建
|
||
|
||
OpenCode附带了多种适用于流行语言的内置LSP服务器：
|
||
|
||
| LSP服务器 | 扩展 | 要求 |
|
||
| --------------------- | ------------------------------------------------------------------- | ---------------------------------------------- |
|
||
| 天文 | .astro | Astro 项目自动安装 |
|
||
| bash | .sh、.bash、.zsh、.ksh | 自动安装bash-语言- 服务器 |
|
||
| 叮叮 | .c、.cpp、.cc、.cxx、.c++、.h、.hpp、.hh、.hxx、.h++ | 自动安装 C/C++ 项目 |
|
||
| 夏普 | .cs | `.NET SDK` 已安装 |
|
||
| Clojure-lsp | 语言.clj、.cljs、.cljc、.edn | `clojure-lsp` 命令可用 |
|
||
| 飞镖 | .dart | `dart` 命令可用 |
|
||
| 给定 | .ts、.tsx、.js、.jsx、.mjs | `deno`命令可用（自动检测deno.json/deno.jsonc） |
|
||
| 长生不老药-LS | .ex、.exs | `elixir` 命令可用 |
|
||
| 埃斯林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue | `eslint` 项目中的依赖项 |
|
||
| 锐利 | .fs、.fsi、.fsx、.fsscript | `.NET SDK` 已安装 |
|
||
| 微光 | .gleam | `gleam` 命令可用 |
|
||
| 男生们 | .go | `go` 命令可用 |
|
||
| HLS | .hs、.lhs | `haskell-language-server-wrapper` 命令可用 |
|
||
| jdtls | .java | `Java SDK (version 21+)` 已安装 |
|
||
| kotlin-ls | .kt、.kts | Kotlin 项目的自动安装 |
|
||
| lua-ls | .lua | 自动安装 Lua 项目 |
|
||
| 尼克斯 | .nix | `nixd` 命令可用 |
|
||
| ocaml-lsp | .ml、.mli | `ocamllsp` 命令可用 |
|
||
| 奥克斯林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue、.astro、.svelte | `oxlint` 项目中的依赖项 |
|
||
| php intelephense | php php .php | PHP 项目的自动安装 |
|
||
| 棱镜 | .prisma | `prisma` 命令可用 |
|
||
| 皮赖特 | .py, .pyi | `pyright` 依赖项已安装 |
|
||
| ruby-lsp（rubocop） | .rb、.rake、.gemspec、.ru | `ruby` 和 `gem` 命令可用 |
|
||
| 生锈 | .rs | `rust-analyzer` 命令可用 |
|
||
| 源套件-lsp | .swift、.objc、.objcpp | `swift` 已安装（`xcode` 在 macOS 上） |
|
||
| 苗条 | .svelte | Svelte 项目的自动安装 |
|
||
| 立场 | .tf、.tfvars | 从 GitHub 版本自动安装 |
|
||
| 微雾 | .typ、.typc | 来自 GitHub 版本自动安装 |
|
||
| 稿件 | 稿件.ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts | `typescript` 项目中的依赖项 |
|
||
| 视图 | .vue | Vue 项目自动安装 |
|
||
| yaml-ls | .yaml、.yml | 自动安装 Red Hat yaml-language-server |
|
||
| 中立 | .zig、.zon | `zig` 命令可用 |
|
||
|
||
当检测到上述文件扩展名之一并且满足要求时，LSP服务器将自动启用。
|
||
|
||
:::note
|
||
您可以通过将`OPENCODE_DISABLE_LSP_DOWNLOAD`环境变量设置为`true`来取消自动LSP服务器下载。
|
||
:::
|
||
|
||
---
|
||
|
||
## 它是如何運作的
|
||
|
||
当opencode打开一个文件时，它：
|
||
|
||
1. 根据所有启用的 LSP 服务器检查文件扩展名。
|
||
2. 如果尚未运行，则启动相应的LSP服务器。
|
||
|
||
---
|
||
|
||
## 配置
|
||
|
||
您可以通过opencode配置中的`lsp`部分自定义LSP服务器。
|
||
|
||
```json title="opencode.json"
|
||
{
|
||
"$schema": "https://opencode.ai/config.json",
|
||
"lsp": {}
|
||
}
|
||
```
|
||
|
||
每个LSP服务器支持以下功能：
|
||
|
||
| 物業 | 類型 | 描述 |
|
||
| ---------------- | -------- | ------------------------------- |
|
||
| `disabled` | 布尔 | 将其设置为`true`以禁用LSP服务器 |
|
||
| `command` | 字符串[] | 启动LSP服务器的命令 |
|
||
| `extensions` | 字符串[] | 此 LSP 服务器应处理的文件扩展名 |
|
||
| `env` | 对象 | 启动服务器时设置的环境变量 |
|
||
| `initialization` | 对象 | 发送到LSP服务器的初始化选项 |
|
||
|
||
讓我們看一些例子。
|
||
|
||
---
|
||
|
||
### 環境變量
|
||
|
||
启动LSP服务器时使用`env`参数设置环境变量：
|
||
|
||
```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`设置为`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 英特尔芬斯
|
||
|
||
PHP Intelephense 通过许可证密钥提供高级功能。您可以通过将（仅）密钥挂钩位于以下位置的文本文件中来提供许可证密钥：
|
||
|
||
- 在 macOS/Linux 上：`$HOME/intelephense/licence.txt`
|
||
- 在 Windows 上：`%USERPROFILE%/intelephense/licence.txt`
|
||
|
||
該文件應僅包含許可證密鑰，不包含其他內容。
|