# acorn-jsx 中文文档

规范地址：https://npmcn.com/package/acorn-jsx/

版本：5\.3\.2
npm 元数据更新时间：2023-06-22T16:31:22.849Z
中文译文更新时间：2026-11-04T23:46:17.652Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/acorn-jsx
原文对照：https://npmcn.com/package/acorn-jsx/?lang=original
项目主页：https://github.com/acornjs/acorn-jsx
源码仓库：https://github.com/acornjs/acorn-jsx

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

- 包体积（解压后）：24.4 kB，6 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：acorn ^6\.0\.0 \|\| ^7\.0\.0 \|\| ^8\.0\.0
- 首次发布：2014-07-11T07:44:05.808Z
- 最新版本发布：2021-07-09T01:15:57.512Z
- 近 30 天下载量：563417328（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 0 个）

## 中文简介

现代、快速的React.js JSX解析器

## 安装

```sh
npm install acorn-jsx
```

也可以使用：`pnpm add acorn-jsx`、`yarn add acorn-jsx`、`bun add acorn-jsx`

## README

# Acorn-JSX

[![Build Status](https://travis-ci.org/acornjs/acorn-jsx.svg?branch=master)](https://travis-ci.org/acornjs/acorn-jsx) [![NPM version](https://img.shields.io/npm/v/acorn-jsx.svg)](https://www.npmjs.org/package/acorn-jsx)

这是一个插件 [橡子](http://marijnhaverbeke.nl/acorn/) 一个小巧，快速的JavaScript解析器，完全用JavaScript编写。

它是作为一种实验性的替代方案而创建的，速度更快 [React.js JSX](http://facebook.github.io/react/docs/jsx-in-depth.html) 解析器。后来，它取代了 [官方解析器](https://github.com/facebookarchive/esprima) 并且现在被许多著名的开发工具所使用。

## Transpiler

请注意，此工具仅将源代码解析为JSX AST，这对于各种语言工具和服务都很有用。如果你想用源代码映射将你的代码转换成符合es5标准的JavaScript，请查看 [巴别塔](https://babeljs.io/) 和 [布雷](https://buble.surge.sh/) 转译器使用 `acorn-jsx` 在引擎盖下面。

## 用法

要求这个模块为你提供了一个Acorn插件，你可以这样使用：

```javascript
var acorn = require("acorn");
var jsx = require("acorn-jsx");
acorn.Parser.extend(jsx()).parse("my(<jsx/>, 'code');");
```

注意，官方规范不支持在标记名中混合使用XML名称空间和对象样式访问（#27） `<namespace:Object.Property />`，所以在 `acorn-jsx@3.0`． 如果你仍然想选择支持这些结构，你可以传递以下选项：

```javascript
acorn.Parser.extend(jsx({ allowNamespacedObjects: true }))
```

此外，由于大多数应用使用纯React转换器，因此引入了一个新选项，允许完全禁止命名空间：

```javascript
acorn.Parser.extend(jsx({ allowNamespaces: false }))
```

注意，默认情况下 `allowNamespaces` 为规范遵从性而启用。

## 许可证

这个插件是在 [麻省理工学院的许可](https://npmcn.com/package/acorn-jsx/LICENSE)。

## 常见问题

### acorn-jsx 是什么？

现代、快速的React\.js JSX解析器

### 如何安装 acorn-jsx？

在项目目录运行 npm install acorn-jsx，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：acorn（^6\.0\.0 \|\| ^7\.0\.0 \|\| ^8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### acorn-jsx 支持 TypeScript 吗？

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

### acorn-jsx 可以商用吗？

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

### acorn-jsx 的下载量有多少？

根据 npm 官方下载统计，acorn-jsx 在 2026/10/04 – 2026/11/02 这 30 天内被下载 563,417,328 次，日均约 18,780,578 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### acorn-jsx 还在维护吗？

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