跳到主要内容

Zed 扩展

nudo Zed 扩展把 Nudo 语言服务器挂到 JavaScript / TypeScript buffer 上,作为次要 language server——与 vtsls / typescript-language-server 并存。

前置条件​

  • Zed 内置 Node 运行时(用于启动服务器)
  • @nudojs/lsp ≥ 0.5.0——扩展会通过 Zed 托管 npm 自动安装,无需手动准备

0.5.0+ 自带 dist/server.js 与 nudo-lsp shebang 入口,并在未传 transport 参数时默认走 stdio。

安装​

扩展位于独立仓库:nudojs/nudo-zed。

源码安装(开发)​

git clone https://github.com/nudojs/nudo-zed

在 Zed 中:Extensions → Install Dev Extension… → 选择克隆下来的 nudo-zed 目录。

设置​

~/.config/zed/settings.json(或项目 .zed/settings.json)的复制即用默认配置:

{
"languages": {
"JavaScript": {
"language_servers": ["vtsls", "nudo", "..."]
},
"TypeScript": {
"language_servers": ["vtsls", "nudo", "..."]
}
},
"code_lens": "on",
"inlay_hints": { "enabled": true },
"semantic_tokens": "combined"
}

"..." 会保留其余已注册 language server。semantic_tokens: "combined" 把服务器的 contract / generated / derived modifier 叠加到语法高亮上(类型感知高亮)。

覆盖二进制路径​

跳过托管安装,直接指定服务器(与其它 Zed LSP 扩展同一配置面):

{
"lsp": {
"nudo": {
"binary": {
"path": "node",
"arguments": ["/abs/path/node_modules/@nudojs/lsp/dist/server.js"]
}
}
}
}

或 PATH 上已有 nudo-lsp 时:

{
"lsp": {
"nudo": {
"binary": { "path": "nudo-lsp", "arguments": [] }
}
}
}

LSP 设置透传​

lsp.nudo.settings 与 lsp.nudo.initialization_options 会转发给语言服务器 (与 VS Code 的 LSP 设置面一致)。项目分析配置(analysis.mode / include / exclude)仍在 package.json#nudo 或 nudo.json。

服务器解析​

扩展通过 Zed 托管 npm 安装 @nudojs/lsp(npm_install_package),并以 <node_binary_path>/node_modules/@nudojs/lsp/dist/server.js --stdio 启动——与其它 Zed language-server 扩展同一模式。用户若配置了 lsp.nudo.binary,则优先使用该覆盖路径。

Zed 中的能力​

能力说明
Diagnostics分析目标(.js/.mjs/.ts)自动分析;无指令文件见 nudo.analysis.mode
Hover 类型
跳转定义 / 引用 / 重命名标准 LSP(含侧车绑定名)
Inlay hints需打开 inlay_hints.enabled;implicit 导出标 derived。参数契约 hint(where …)默认关——经 language-servers.nudo.initialization_options: { "inlayHints": { "parameters": true } }(或 package.json#nudo.inlayHints.parameters)开启;开启后展示契约声明形态(侧车模板表达式 / 指令约束名,如 where nullable(astNode)),完整谓词经 hint tooltip 展示
CodeLens需打开 code_lens: "on"——观察选择器:●/○ contract / hw|gen|imp(默认激活)+ persist/update + ⚡ draft contract;●/○ case "…" 选项跟随
Semantic tokens默认关闭,设 semantic_tokens: "combined"——含 contract/generated/derived modifier
Code actions / Signature help标准 LSP quickfix 与 signature help(真实 paramTypes / 返回类型)。含 action-map quickfix([fix] / [silence] / [review] / [adjust] / [scaffold])
Agent 命令(nudo.check / nudo.contract.draft / …)经任意 LSP 客户端或 Zed agent 工具可达
JSX / TSX buffer已挂接(JavaScript React / TypeScript React),与 VS Code 同文档面

CodeLens ⚡ draft contract 与 CLI nudo contract --draft 同源(仅客户端显式 write: true 时写 *.nudo.draft.js)。迁移步骤:迁移已有 JS。

VS Code 扩展里 active case 的 decoration 在 Zed 无对应 API,请改用 CodeLens 的 case 选择。

完整客户端对比与已知缺口:LSP 客户端矩阵。

文件检测​

分析目标为 .js / .mjs / .ts。package.json#nudo.analysis.mode 出厂默认 "exports";模式语义与保守的 "directives" 门禁:共存。CodeLens contract 档使用更宽的目标路径。

构建 WASM 扩展​

安装 dev extension 时 Zed 会自行编译。手动构建:

rustup target add wasm32-wasip2
cd nudo-zed
cargo build --target wasm32-wasip2 --release

参见​