# @gerhobbelt/esprima 中文文档

规范地址：https://npmcn.com/package/%40gerhobbelt/esprima/

版本：4\.0\.1-27
npm 元数据更新时间：2022-04-05T13:58:46.808Z
中文译文更新时间：2026-11-16T05:20:56.159Z
软件包许可：BSD-2-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40gerhobbelt/esprima
原文对照：https://npmcn.com/package/%40gerhobbelt/esprima/?lang=original
项目主页：http://esprima.org/
源码仓库：https://github.com/GerHobbelt/esprima

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

- 包体积（解压后）：330 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=4
- 运行依赖：0 个
- 首次发布：2017-10-13T16:16:40.305Z
- 最新版本发布：2019-07-19T11:12:15.476Z
- 近 30 天下载量：24448（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 0 个）

## 中文简介

ECMAScript 分析多用途分析的基础设施

## 安装

```sh
npm install @gerhobbelt/esprima
```

也可以使用：`pnpm add @gerhobbelt/esprima`、`yarn add @gerhobbelt/esprima`、`bun add @gerhobbelt/esprima`

## README

[![NPM version](https://img.shields.io/npm/v/esprima.svg)](https://www.npmjs.com/package/@gerhobbelt/esprima) [![npm download](https://img.shields.io/npm/dm/esprima.svg)](https://www.npmjs.com/package/@gerhobbelt/esprima) [![Build Status](https://img.shields.io/travis/GerHobbelt/esprima/master.svg)](https://travis-ci.org/GerHobbelt/esprima) [![Coverage Status](https://img.shields.io/codecov/c/github/GerHobbelt/esprima/master.svg)](https://codecov.io/github/GerHobbelt/esprima)

> # 页:1
> 
> 这个叉子/棋子 `esprima` 仔细跟踪原始,但添加支持 解析 [贾森](https://github.com/GerHobbelt/jison) 动作代码块,哪些 在JavaScript代码中可能包含JISON特定标识符,例如. `$1`, (中文(简体) ), `@1`, (中文(简体) ), `#1` 财务报告和审定财务报表 `#ID#`。 。 。 .

**埃斯皮里亚** (单位:千美元)[(原始内容存档于2018-09-26). esprima.org](http://esprima.org/), BSD 许可证)是一种高性能, 符合标准的 [ECMAS脚本](http://www.ecma-international.org/publications/standards/Ecma-262.htm) 以 ECMAScript 编写的 parser (也俗称 : [Java 脚本](https://en.wikipedia.org/wiki/JavaScript)) (中文(简体) ). Esprima的创建和维护者为: [阿里亚·希达亚特](https://twitter.com/ariyahidayat), (中文(简体) ), 在帮助下 [许多捐助者](https://github.com/GerHobbelt/esprima/contributors)。 。 。 .

### 特征

-   全面支持ECMASCRIPT 2017 (中文(简体) )[ECMA-262 第8版](http://www.ecma-international.org/publications/standards/Ecma-262.htm)(中文(简体) )
-   灵敏 [语法树格式](https://github.com/estree/estree/blob/master/es5.md) 标准 [ESTree项目](https://github.com/estree/estree)
-   实验支持 [联合来文十](https://facebook.github.io/jsx/),用于 [反应](https://facebook.github.io/react/)
-   可选跟踪语法节点位置(基于索引和行栏)
-   [重度测试](http://esprima.org/test/ci.html) (约 1500) [单位测试](https://github.com/GerHobbelt/esprima/tree/master/test/fixtures) 与 [全码覆盖](https://codecov.io/github/GerHobbelt/esprima)(中文(简体) )

### API 密码

Esprima可以用来表演 [逻辑分析](https://en.wikipedia.org/wiki/Lexical_analysis) (电话化)或 [综合分析](https://en.wikipedia.org/wiki/Parsing) 一个JavaScript程序的 (parsing).

关于Node.js REPL的一个简单例子:

```javascript
> var esprima = require('esprima');
> var program = 'const answer = 42';

> esprima.tokenize(program);
[ { type: 'Keyword', value: 'const' },
  { type: 'Identifier', value: 'answer' },
  { type: 'Punctuator', value: '=' },
  { type: 'Numeric', value: '42' } ]
  
> esprima.parse(program);
{ type: 'Program',
  body:
   [ { type: 'VariableDeclaration',
       declarations: [Object],
       kind: 'const' } ],
  sourceType: 'script' }
```

更多信息,请改为: [完整文档](http://esprima.org/doc)。 。 。 .

## 常见问题

### @gerhobbelt/esprima 是什么？

ECMAScript 分析多用途分析的基础设施

### 如何安装 @gerhobbelt/esprima？

在项目目录运行 npm install @gerhobbelt/esprima，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 esparse、esvalidate，可以用 npx esparse 直接运行。

### @gerhobbelt/esprima 支持 TypeScript 吗？

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

### @gerhobbelt/esprima 支持 ESM 还是 CommonJS？

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

### @gerhobbelt/esprima 需要什么版本的 Node\.js？

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

### @gerhobbelt/esprima 可以商用吗？

@gerhobbelt/esprima 使用 BSD-2-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gerhobbelt/esprima 的下载量有多少？

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

### @gerhobbelt/esprima 还在维护吗？

最新版本 4\.0\.1-27 发布于 2019/07/19（7 年前）；至今共发布 21 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

