# @aws/lsp-partiql 中文文档

规范地址：https://npmcn.com/package/%40aws/lsp-partiql/

版本：0\.0\.24
npm 元数据更新时间：2026-08-18T22:42:14.865Z
中文译文更新时间：2026-11-07T16:34:53.408Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws/lsp-partiql
原文对照：https://npmcn.com/package/%40aws/lsp-partiql/?lang=original
项目主页：https://github.com/Amazon-Q-Developer/language-servers#readme
源码仓库：https://github.com/Amazon-Q-Developer/language-servers

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

- 包体积（解压后）：7.3 MB，63 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2024-05-31T13:11:21.400Z
- 最新版本发布：2026-08-18T22:42:14.577Z
- 近 30 天下载量：4753（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 6 个）

## 中文简介

PartiQL 语言服务器

## 安装

```sh
npm install @aws/lsp-partiql
```

也可以使用：`pnpm add @aws/lsp-partiql`、`yarn add @aws/lsp-partiql`、`bun add @aws/lsp-partiql`

## README

# PartiQL LSP 服务器

用于 LSP 服务器 [PartiQL语言](https://partiql.org/)。此服务器通过使用 [由PartiQL团队维护的 Rust parser](https://github.com/partiql/partiql-lang-rust)。 。 。 .

此解析器是使用 PartiQL 团队在 [PartiQL 游乐场套装](https://github.com/partiql/partiql-rust-playground)。此二进制被进一步编码为Javascript文件中的基数64字符串,以方便与服务器的其他资产捆绑在一起.

### 更新二进制

_更新二进制需要 Docker CLI 在您的路径中_

要更新服务器使用的二进制, 请运行 `npm run update-parser-binary`。这将在一个多克容器内,从 GitHub 中取出 PartiQL 游乐场存储器并运行 `build` 命令创建新的二进制。 然后在Typescript文件中将其编码为Base64并复制到 `src` 文件夹。 运行 `npm run build` 然后将二进制文件移植到 Javascript 并将其放入 `lib` 文件夹.

更新软件包中使用的二进制 `web-tree-sitter`运行 `npm run update-treesitter-wasm`。该更新将被迫使每次升级版本 `web-tree-sitter`。这将汇编 `tree-sitter.wasm` 软件包内的文件在TypeScript文件中输入一个基数64字符串到 `src/tree-sitter-parser` 文件夹为 `tree-sitter-inline.ts`。 。 。 .

### 更新 ANTR 词汇和解析器

ANTR 语法和解析语法定义于 `src/antlr-grammar`中的文件 `src/antlr-generated` 从语法文件中自动生成。 改为: 更新这些文件, 运行 `npm run update-antlr`。当前语法文件可见于 [https://github.com/partiql/partiql-lang-kotlin/tree/main/partiql-parser/src/main/antlr 互联网档案馆的存檔,存档日期2013-12-22](https://github.com/partiql/partiql-lang-kotlin/tree/main/partiql-parser/src/main/antlr)。 。 。 .

### 测试

此软件包的测试正在使用 [欢乐](https://jestjs.io/),以运行此套件中的测试 `-npm run test`。 。 。 .

### 可能的改进

这一一揽子方案目前具有若干潜在的改进点:

-   在解析器 WASM 二进制的绑定中,有一个代码路径可以导入 `partiql_playground_bg.wasm` 文档。 由于WASM二进制的内嵌,我们不会在运行时使用这个文件和代码路径. 然而,在进行导入检查时, Webpack 无法构建,因为它找不到此二进制 。 为了解决这个问题,我们包括一个没有预想名字的文件.
-   在语言服务测试中,有几条未经测试的快乐道路. 无法找到投入来触发这些快乐的道路.

## 常见问题

### @aws/lsp-partiql 是什么？

PartiQL 语言服务器

### 如何安装 @aws/lsp-partiql？

在项目目录运行 npm install @aws/lsp-partiql，或使用 pnpm add / yarn add / bun add。

### @aws/lsp-partiql 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aws/lsp-partiql 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aws/lsp-partiql 可以商用吗？

@aws/lsp-partiql 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws/lsp-partiql 的下载量有多少？

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

### @aws/lsp-partiql 还在维护吗？

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