# @ghul/language-server 中文文档

规范地址：https://npmcn.com/package/%40ghul/language-server/

版本：1\.37\.3
npm 元数据更新时间：2026-11-15T11:03:54.094Z
中文译文更新时间：2026-11-16T08:09:45.405Z
软件包许可：GPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ghul/language-server
原文对照：https://npmcn.com/package/%40ghul/language-server/?lang=original
项目主页：https://ghul.dev/
源码仓库：https://github.com/ghul-lang/ghul-vsce

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.6 MB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-08-12T13:46:28.004Z
- 最新版本发布：2026-11-15T11:03:53.731Z
- 近 30 天下载量：6458（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：165（近 12 个月 165 个）

## 中文简介

Ghūl编程语言语言服务器, 用于任何 LSP 能力编辑器

## 安装

```sh
npm install @ghul/language-server
```

也可以使用：`pnpm add @ghul/language-server`、`yarn add @ghul/language-server`、`bun add @ghul/language-server`

## README

# ghūl 语言服务器

语言服务器 [ghūl 编程语言](https://ghul.dev/),用于任意 说LSP的编辑器.

这是同一个服务器 [VS 代码扩展](https://marketplace.visualstudio.com/items?itemName=degory.ghul) 运行, 将直接发射。 维基百科 代码用户不需要它: 安装 扩展名.

## 所需资源

-   节点.js 20 或以后,运行服务器本身.
-   .NET SDK, 和一个ghūl项目 `.config/dotnet-tools.json` 针头 `ghul.compiler`。服务器恢复并驱动用于分析的编译器 模式;它不分析其自身.

## 安装

```sh
npm install -g @ghul/language-server
```

软件包安装的命令是 `ghul-language-server`。 。 。 .

或者下载 `ghul-language-server-<version>.tgz` 从a [释放](https://github.com/ghul-lang/ghul-vsce/releases) 把它拆开 这个 内容列在 `package/`,可执行文件是 `package/bin/ghul-language-server.js`。 。 。 .

## 运行

```sh
ghul-language-server --stdio
```

`--node-ipc`, (中文(简体) ), `--socket=<port>` 财务报告和审定财务报表 `--pipe=<name>` 还有工作 没有 传输参数服务器默认为 stdio .

工作空间根客户端报告必须是包含 `.ghulproj`,这样服务器就可以找到项目及其工具的显示.

## 编辑器配置

### 尼欧维姆

```lua
vim.filetype.add({ extension = { ghul = "ghul" } })

vim.lsp.config.ghul = {
  cmd = { "ghul-language-server", "--stdio" },
  filetypes = { "ghul" },
  root_markers = { "*.ghulproj", ".git" },
}

vim.lsp.enable("ghul")
```

### 螺旋

单位 `languages.toml`数字 :

```toml
[language-server.ghul]
command = "ghul-language-server"
args = ["--stdio"]

[[language]]
name = "ghul"
scope = "source.ghul"
file-types = ["ghul"]
roots = ["*.ghulproj"]
language-servers = ["ghul"]
```

### 埃马克斯( 格洛特)

```elisp
(define-derived-mode ghul-mode prog-mode "ghūl")
(add-to-list 'auto-mode-alist '("\\.ghul\\'" . ghul-mode))
(with-eval-after-load 'eglot
  (add-to-list 'eglot-server-programs
               '(ghul-mode . ("ghul-language-server" "--stdio"))))
```

## 支持的请求

完成、徘徊、定义、宣布、类型定义、执行、, 引用、重命名、文档和工作空间符号、签名帮助、文档 和范围格式化,语义符号化,内置提示,快取代码动作, 还有诊断.

语法突出来自语义符号,所以编辑器不 请显示未显示的文本。 没有文本Mate语法或 此套件中的树保姆解析器; VS 代码扩展带自己的 语法.

## 常见问题

### @ghul/language-server 是什么？

Ghūl编程语言语言服务器, 用于任何 LSP 能力编辑器

### 如何安装 @ghul/language-server？

在项目目录运行 npm install @ghul/language-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ghul-language-server，可以用 npx ghul-language-server 直接运行。

### @ghul/language-server 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ghul\_\_language-server 是否存在。

### @ghul/language-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ghul/language-server 可以商用吗？

@ghul/language-server 使用 GPL-3\.0 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @ghul/language-server 的下载量有多少？

根据 npm 官方下载统计，@ghul/language-server 在 2026/10/17 – 2026/11/15 这 30 天内被下载 6,458 次，日均约 215 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ghul/language-server 还在维护吗？

最新版本 1\.37\.3 发布于 2026/11/15（今天）；至今共发布 165 个版本，其中过去 12 个月发布了 165 个；首次发布于 2026/08/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

