返回博客
文章tutorialverboo codedev toolsagente de programação

Verboo Code 的 LSP:如何让智能体找到定义和类型错误

Mafra2026年11月20日阅读约 5 分钟

智能体改完一个 TypeScript 文件,执行你要求的命令,然后说已经完成。类型错误要等到你构建或者 CI 报错时才出现。在那之前,它一直在摸黑工作:读文件、凭推断做出选择、继续往下走。

Verboo Code 的 /lsp 命令正好补上这个缺口。它把语言服务器接到智能体上,从那一刻起,对话可以真正查询定义、引用、类型和诊断,而不是根据文件文本猜。

整个过程有四步,全部在终端里完成:查看当前状态、找到适合你项目的插件、安装二进制和插件、确认智能体已经能看见代码。

接上语言服务器后,智能体多了什么?

它得到两样没有 LSP 就不存在的能力:结构化的代码查询,以及自动诊断。

查询来自一个支持九种操作的工具。每种操作都需要文件路径、行号和列号,从 1 开始计数,和编辑器里看到的一致:

操作返回什么
goToDefinition符号定义的位置
findReferences该符号在项目中的所有使用位置
hover该位置的类型和文档
documentSymbol文件里的函数、类和变量
workspaceSymbol整个工作区里的符号
goToImplementation接口或抽象方法的实现
prepareCallHierarchy调用层级分析的起点
incomingCalls调用该位置函数的函数
outgoingCalls该函数调用的函数

诊断是另一半。服务器在编辑后发布错误时,Verboo Code 会把诊断作为附件送进对话,不需要你主动询问。每次发送上限为每个文件 10 条、每批 30 条,已经发送过的诊断不会在下一轮重复出现。

怎么检查是否已经有 LSP 服务器在运行?

在会话里运行 /lsp status。它会显示初始化状态,以及每个来自插件的服务器。

> /lsp status

LSP status
Initialization: success
Configured plugin LSP servers: 1
- typescript (state: running)
  command: typescript-language-server --stdio
  extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx

如果列表为空,输出会以 Configured plugin LSP servers: none 结束。状态是 stopped 不算失败:这是懒启动,第一次查询时才拉起进程,在不用该语言的项目里节省内存。

怎么找到适合自己项目的插件?

运行 /lsp recommend,指向文件夹、某个文件或某个扩展名。命令会读取项目的扩展名,按出现频率排序,再和已安装市场里的 LSP 插件做匹配。

> /lsp recommend .

LSP recommendations for .
- typescript-lsp@claude-plugins-official (not installed, binary: found)
  command: typescript-language-server
  extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx
  description: TypeScript/JavaScript language server for enhanced code intelligence
  next: /lsp install typescript-lsp@claude-plugins-official

括号里的两个标记要分开看。not installed 说的是插件。binary: found 说的是服务器可执行文件,它必须在 PATH 里。二进制缺失时,输出会把最后一行换成一个代码块,里面有安装命令和验证命令。

Verboo Code 有自己的市场 verboo-plugins,同时把生态的官方插件市场作为第二来源。语言类插件在第二个市场里,找不到候选时 /lsp recommend 会自动注册它。这需要系统里有 git。没有的话,输出会提示市场暂时不可用。

怎么安装二进制和插件?

两样东西,顺序很重要:先装服务器可执行文件,再装告诉 Verboo Code 怎么调用它的插件。表格里的命令就是二进制缺失时 /lsp recommend 打印出来的内容。

语言插件安装二进制验证
TypeScript 和 JavaScripttypescript-lspnpm install -g typescript typescript-language-servertypescript-language-server --version
Pythonpyright-lspnpm install -g pyrightpyright-langserver --help
Gogopls-lspgo install golang.org/x/tools/gopls@latestgopls version
Rustrust-analyzer-lsprustup component add rust-analyzerrust-analyzer --version
C 和 C++clangd-lspsudo apt install clangdclangd --version
PHPphp-lspnpm install -g intelephenseintelephense --version
Rubyruby-lspgem install ruby-lspruby-lsp --version
C#csharp-lspdotnet tool install --global csharp-lscsharp-ls --version

二进制在 PATH 里之后,用完整 id 安装插件,@ 后面是市场名:

> /lsp install typescript-lsp@claude-plugins-official

Installed typescript-lsp@claude-plugins-official. Activated 1 plugin LSP server.

安装作用在用户级别:对这台机器上的所有项目生效,不只是当前打开的文件夹。要撤销,运行 /lsp uninstall typescript-lsp@claude-plugins-official。

二进制必须位于打开 Verboo Code 的那个进程的 PATH 里。用 nvm 装 Node 的人最容易在这里踩坑:npm 的全局目录只有在 nvm 加载后才进入 PATH。先打开终端、加载 nvm,再调用 verboo。如果安装看起来没问题,/lsp recommend 却仍报 binary: missing,先运行 which typescript-language-server,再去怀疑插件。

怎么确认智能体已经能看见代码?

再运行一次 /lsp status,确认服务器出现在列表里。然后提一个只有服务器能回答的问题,比如某个类型定义在哪里、谁在调用某个函数。智能体会用行号和列号调用 LSP 工具,返回真实位置,而不是文本搜索的结果。

最快的验证是错误。让它做一次故意破坏类型的修改。服务器在运行时,错误会在同一次回复里返回,早于任何 tsc。没有服务器时,工具会返回 No LSP server available for file type: .ts,智能体只有跑到构建阶段才会发现问题。

服务器起不来怎么办?

三种原因几乎覆盖所有情况:二进制不在 PATH、插件缺失、内存里留着旧配置。

  • 推荐结果里出现 binary: missing:安装可执行文件,再用表格里的验证命令确认。
  • Configured plugin LSP servers: none:插件没装或被禁用。/lsp install 解决第一种情况。
  • 服务器带着旧配置:/lsp restart 重启管理器并重新读取插件。
> /lsp restart

LSP restarted. 1 server configured.

初始化失败时,/lsp status 会显示 Initialization: failed 和错误信息,每个有问题的服务器还会带一行 last error。真正的原因就在那里,比如命令不存在或者启动超时。

如果问题出在环境而不是服务器,/doctor 可以把诊断做完:它会读取安装方式、PATH 和配置,然后你再决定要不要重装。

/lsp 不会猜你的技术栈:它读取项目,打印插件和二进制安装命令。如果你的项目是 TypeScript,在 Verboo Code 里打开文件夹,运行 /lsp recommend .,看看它对你这个仓库给出的真实推荐。

喜欢这篇文章吗?
把知识分享给你的朋友。
// 继续阅读

相关文章