使用语言服务器为 GitHub Copilot CLI 提供真正的代码智能

您是否曾见过 GitHub Copilot CLI 将 JAR 文件解压到临时目录，通过 grep 搜索 .class 文件，然后从原始字节码中拼凑出 API 签名？代理虽然足智多谋，但没有语言服务器，这是它最好的表现。

语言服务器协议（LSP）是驱动 VS Code 等编辑器中“转到定义”、“查找引用”和类型解析的标准。它在终端中同样适用。LSP 设置技能可自动安装和配置 Copilot CLI 的 LSP 服务器，使代理能够获得关于代码的精确、结构化答案，而不是依赖文本搜索启发式方法。

在本文中，您将了解该技能的内部工作原理、它生成的配置格式，并为其目前支持的 14 种语言中的任何一种进行设置。

问题：启发式代码理解

在没有 LSP 服务器的情况下，GitHub Copilot CLI 中的代理通过文本搜索和二进制提取逆向工程 API 信息。对于 Java 项目，这可能看起来像：

查找依赖 JAR

find ~/.m2/repository -name "*httpclient*.jar"

解压到临时目录

mkdir /tmp/httpclient && cd /tmp/httpclient jar xf ~/.m2/repository/org/apache/httpcomponents/httpclient/4.5.14/httpclient-4.5.14.jar

搜索提取的类文件中的方法

grep -r "execute" --include="*.class" .

对于 Python，代理可能会 cat site-packages 内的文件。对于 TypeScript，它会遍历 node_modules。这些基于文本的方法适用于简单情况，但它们在原始文本上进行模式匹配，而不是真正的语义分析，因此会遗漏泛型、重载和传递类型，并且根本无法查看编译后的字节码。这正是语言服务器弥补的差距。

LSP 服务器从结构上解决了这个问题。当代理发送某个符号的 textDocument/definition 请求时，语言服务器返回精确的源位置、完全解析的类型和签名。

LSP 设置技能的工作原理

触发后，该技能执行一个七步工作流：

1. 语言选择

代理使用 ask_user 提供一组选择，以确定用户需要 LSP 支持的语言。这一步驱动所有后续步骤。

1. 操作系统检测

代理运行 uname -s（或在 Windows 上检查 $env:OS / %OS%）来确定目标平台。安装命令因操作系统而异。例如，在 macOS 上使用 brew install jdtls，在 Linux 上则从 eclipse.org 下载。

1. LSP 服务器查找

该技能包含一个参考文件（references/lsp-servers.md），其中包含 14 种语言的精选数据：每个操作系统的安装命令、二进制名称和现成的配置片段。代理读取该文件并选择匹配的条目。

1. 配置范围

代理询问配置应应用于：

用户级别：~/.copilot/lsp-config.json — 应用于所有仓库

仓库级别：仓库根目录下的 lsp.json 或 .github/lsp.json — 限定于单个项目

如果两者都存在，仓库级别的配置优先。

1. 安装

代理运行相应的安装命令。例如：

任何操作系统上的 TypeScript

npm install -g typescript typescript-language-server

macOS 上的 Java

brew install jdtls

任何操作系统上的 Rust

rustup component add rust-analyzer

1. 配置

代理将条目写入或合并到所选配置文件。格式使用 lspServers 对象，其中每个键是服务器标识符：

{ "lspServers": { "java": { "command": "jdtls", "args": [], "fileExtensions": { ".java": "java" } } } }

该技能强制执行的关键规则：

command 必须在 $PATH 上或是绝对路径

args 通常包含 "--stdio" 用于标准 I/O 传输（某些服务器如 jdtls 内部处理此操作）

fileExtensions 将每个扩展名（带前导点）映射到语言标识符

配置文件中的现有条目将被保留 — 代理进行合并，从不覆盖

1. 验证

代理运行 which（或在 Windows 上运行 where.exe）以确认服务器可访问，然后验证配置文件是否为格式正确的 JSON。

支持的语言

该技能为多种编程语言预定义了一组语言服务器。如果编码代理遇到尚未映射的语言，它将搜索合适的服务器并引导您进行手动配置。

设置后的变化

一旦配置了 LSP 服务器，CLI 代理可以：

跨依赖项解析类型 — 不再需要 grep 搜索 JAR 文件或 node_modules

跳转到第三方库中的定义，即使源代码未检入仓库

在整个项目中查找对某个符号的所有引用

读取任何函数、类或类型的悬停文档

这意味着代理在工具调用上花费的时间更少，并在第一次通过时产生更准确的代码。对您来说，这意味着更少的时间等待代理解压缩 JAR 文件或 grep 搜索 node_modules 来回答您的 IDE 已经知道的问题，更少基于错误签名的错误转向。代理以与您的编辑器中“转到定义”相同的结构化理解来推理您的代码，因此您可以交给它更大、更棘手的任务并信任结果。

开始使用

下载技能：访问 Awesome Copilot LSP 设置技能页面，点击下载按钮获取 ZIP 文件。

将 ZIP 解压到 ~/.copilot/skills/：运行

unzip lsp-setup.zip -d ~/.copilot/skills/

重启 GitHub Copilot CLI：如果 Copilot CLI 已在运行，先输入 /exit。然后重新启动 copilot，以便它拾取新技能。

要求代理设置语言服务器：例如，“为 Java 设置 LSP”或“启用 Python 的代码智能”。

验证：技能安装并配置 LSP 服务器后，再重启一次 Copilot CLI（/exit，然后重新启动），运行 /lsp 检查服务器状态，然后尝试在其中一个依赖项中的符号上使用转到定义。

该技能是 Awesome Copilot 项目的一部分。它是开源的，因此欢迎贡献和反馈！