给 Crush 配上 LSP:AI 找定义不再靠猜-开发者社区

给 Crush 配上 LSP:AI 找定义不再靠猜

【免费下载链接】crushGlamourous agentic coding for all 💘项目地址: https://gitcode.com/gh_mirrors/crush3/crush

刚在 A 文件里改了个变量名，AI 接着改 B 文件时却还在用旧名字猜引用，给出的建议一半是错的。问题出在它只看得懂文本，看不懂代码语义。Crush 的 LSP 集成解决的正是这件事:让 AI 像真正的 IDE 一样，向语言服务器询问定义、引用和诊断，而不是满仓库搜字符串。

一、它到底在做什么

说白了，就是给 AI 装了一副能看代码骨架的眼镜。以前 AI 靠 grep 逐字符匹配，同名变量、注释里的示例、字符串里的巧合都会误报;现在它把问题交给语言服务器，由服务器带着完整的类型和范围信息回答"这个符号定义在哪、被谁调用"。这就是与纯文本匹配的本质区别:一个看"字面相同"，一个看"语义相同"。

二、3分钟跑通

如果你只想要最简结果，跳到这一节。

先装好语言服务器(以 Go 为例:go install gopls@latest,确认which gopls有输出),然后在项目根目录的crush.json里写最小配置:

{ "lsp": { "gopls": { "command": "gopls" } } }

在项目根目录启动 crush,让 AI 查一个符号的定义:

crush

看到工具输出显示它调用了lsp_definition并返回文件路径加行号,就说明链路通了。args、filetypes、root_markers、options这些配置项默认值就能覆盖绝大多数场景,先不碰。

三、拆开来看内部怎么转

三个核心模块,各自一句话职责:

internal/lsp/manager.go —— 调度台:按文件类型和项目根标记决定启动哪个服务器,懒加载并维护连接
internal/lsp/client.go —— 通信线:负责与单个语言服务器握手、打开文件、接收诊断
internal/agent/tools/lsp_definition.go —— 暴露给 AI 的窗口:lsp_definition等 LSP 工具的实现

以一次lsp_definition调用为例,完整链路是这样的:

触发:AI 调用工具,manager 收到当前工作目录,开始检查该启动哪些服务器
manager 逐个比对各服务器的filetypes和root_markers,只启动匹配的那个;已经在跑的客户端直接复用
客户端与语言服务器做initialize握手,成功后把root_markers指向的关键配置文件打开,让服务器掌握项目基本盘
工具先用词边界 grep 符号拿到候选位置,再逐个问 LSP 确认是不是真标识符,注释和字符串里的同名文本在这一步被自动过滤
LSP 返回定义位置,工具整理成文件、行号和上下文回传给 AI
并行地,服务器推送新诊断时,回调会实时更新 UI 上的错误数量

四、进阶定制

场景一:给语言服务器注入环境变量

场景描述:多版本工具链的仓库里,gopls 需要指定 Go 版本,否则启动即报错
配置要点:在对应 lsp 条目里加env字段,值支持 shell 变量展开,可写${VAR}复用现有环境
注意事项:env只作用于该服务器进程,不会污染主 shell 和其他工具的环境

"env": { "GOTOOLCHAIN": "go1.24.5" }

场景二:多语言路由

场景描述:一个仓库里 Go 服务和 TypeScript 前端并存,希望打开.ts命中 TS 服务器、.go命中 gopls
配置要点:给每个 lsp 条目声明filetypes和root_markers,manager 会按文件类型自动路由
注意事项:node、python、deno这类通用命令在自动启动黑名单里,这类语言必须显式写进配置,别指望它猜

五、容易踩的坑

现象:LSP 一直没启动,AI 退化成 grep。原因:语言服务器二进制不在 PATH,启动失败后短期内不再重试。解法:先装好服务器,用which gopls确认。
现象:大项目初始化超时。原因:默认 30 秒超时太短,大型仓库索引来不及完成。解法:调大配置里的timeout字段。
现象:在 monorepo 子目录里定位失败。原因:root_markers匹配不上,服务器找不到项目根。解法:显式写上go.mod、package.json这类标记文件。
现象:配了 TS 服务器却不自动启动。原因:启动命令是node这类被拉黑的一般性命令。解法:确认command指向语言服务器本体,并显式声明该条目。
现象:改过文件后查询结果还是旧的。原因:变更没同步给服务器,诊断是增量维护的。解法:让 AI 调用lsp_restart工具触发重新分析。