# @enact/cli 中文文档

规范地址：https://npmcn.com/package/%40enact/cli/

版本：7\.4\.0
npm 元数据更新时间：2026-11-09T08:25:40.218Z
中文译文更新时间：2026-11-13T16:34:33.023Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.6 MB，52 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：^22\.15\.0 \|\| \>=24\.0\.0
- 运行依赖：67 个
- peer 依赖：typescript ^5\.4\.0 \|\| ^6\.0\.0 \|\| ^7\.0\.2，@babel/core ^8\.0\.1
- 首次发布：2017-12-21T23:45:29.689Z
- 最新版本发布：2026-11-09T08:25:40.060Z
- 近 30 天下载量：6194（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：95（近 12 个月 10 个）

## 中文简介

用于发布应用程序的全特有建筑环境工具.

## 安装

```sh
npm install @enact/cli
```

也可以使用：`pnpm add @enact/cli`、`yarn add @enact/cli`、`bun add @enact/cli`

## README

# @nact/cli (英语) [![Travis](https://img.shields.io/travis/com/enactjs/cli/master?style=flat-square)](https://app.travis-ci.com/github/enactjs/cli) [![NPM](https://img.shields.io/npm/v/@enact/cli.svg?style=flat-square)](https://www.npmjs.com/package/@enact/cli)

> 用于快速开发应用软件的独立工具包.

## 安装

安装@enact/cli只需要使用npm在全球安装. 用于 Linux `sudo` 可能需要这样做.

```
npm install -g @enact/cli
```

> 注:节点16或更高.

## 创建新应用程序

唯一一次你想要直接使用"颁布CLI"的时候,就是你想创建一个新的项目的时候.

```sh
enact create [directory]
```

这将生成一个基本的 App 模板, 完成 npm 脚本和依赖性 。 如果没有指定目录路径,将在工作目录内生成.

> 高级:如果你已经使用 `npm link` 您可以运行 `enact link` 之后将链接到任何可用的出版图书馆.

## 可用命令

发布支持多个命令,每个命令都可以通过 `enact` 命令和通过 npm 的别名 **软件包.json**对于单个命令的帮助,请添加 `--help` 遵循命令名称。 命令为:

### `enact serve` (别名: `npm run serve`(中文(简体) )

在开发模式中构建并服务应用程序.  
打开 [http://localhost:8080 (英语)](http://localhost:8080/) 在浏览器中查看.

如果您做了编辑, 页面会重新装入 .  

### `enact pack` (别名: `npm run pack`, (中文(简体) ), `npm run pack-p`,以及 `npm run watch`(中文(简体) )

在工作目录中构建工程。 具体来说, `pack` 以开发模式构建,其中代码未被忽略,并包含调试代码,而 `pack-p` 以生产方式建设,每样东西都精细并优化性能. 确保避免在开发模式上进行航运或性能测试.

### `enact clean` (别名: `npm run clean`(中文(简体) )

删除以前从./dist中创建的碎片.

### `enact lint` (别名: `npm run lint`(中文(简体) )

在工程上运行 ESLint 的发布配置,用于语法分析.

### `enact test` (别名: `npm run test` 财务报告和审定财务报表 `npm run test-watch`(中文(简体) )

这些任务将执行所有有效的测试(结束于 `-specs.js`项目目录内的内容。 这个 `test` 是一个标准的单一执行通行证,而 `test-watch` 将设置一个监视器, 当文件更改时重新执行测试 .

### `enact license` (别名: `npm run license`(中文(简体) )

A JSON说明当前项目提及的单元的许可证以及所用单元的任何许可证 `@enact/cli` 可能包含在应用程序的制作中.

## 发布构建选项

@enact/cli工具将检查项目 **软件包.json** 寻找可选选项 `enact` 几个定制选项的对象 :

-   `template` _\[弦\]_ - 用于替代 HTML 模板的文件路径 [网页包装 html-网页包装-插件](https://github.com/jantimon/html-webpack-plugin)。 。 。 .
-   `isomorphic` _\[弦\]_ - 习惯异形兼容入口的替代文件路径。 如果主切入点已经异形兼容,则不需要.
-   `title` _\[弦\]_ - 应该放在HTML中的标题文本 `<title></title>` 标签。 注意: 如果这是 WebOS 项目, 标题默认会自动从 **appinfo.json (英语)** 内容.
-   `alias` _\[标_ - 对建设时使用的网络包装别名路径进行字符串绘图.
-   `theme` _\[标_ - 用于推断的简化字符串名称 `fontGenerator`, (中文(简体) ), `ri`,以及 `screenTypes` 预设值来源。 譬如说, `"limestone"`。 。 。 .
-   `fontGenerator` _\[弦\]_ - 通用JS字体Generator模块的Filepath,该模块将构建本地化字体CSS,以注入HTML。 默认情况下,会使用指定主题的任何预设或倒向石灰岩.
-   `ri` _\[标_ - 决议独立性选项,将提交 [决议-独立](https://github.com/enactjs/postcss-resolution-independence)。默认情况下,将使用任何用于指定主题的预设或倒向石灰岩.
    -   `baseSize` _\[号_ - 将基单元的值转换为分辨率独立单元时使用的根字体大小。 例如,何时 `baseSize` lESS文件中的48px将被转换为2rem.
-   `screenTypes` _\[阵列\]_ - 组合1个或更多屏幕类型定义,用于前发HTML初始化。 也可以引用 json 文件路径读取屏幕类型定义 。 默认情况下,会使用指定主题的任何预设或倒向石灰岩.
-   `nodeBuiltins` _\[标_ - 用于多填充节点JS内置的配置设置。 见 `node` [网络软件包选项](https://webpack.js.org/configuration/node/)。 。 。 .
-   `resolveFallback` _\[标_ - 正常解析失败时用于重定向模块请求的配置设置 。 见 `resolve.fallback` [网络软件包选项](https://webpack.js.org/configuration/resolve/#resolvefallback)。 。 。 .
-   `externalStartup` _\[叫声\]_ - 旗号是否将通常在预发应用程序 HTML 输出内嵌的启动/更新js外部化 .
-   `forceCSSModules` _\[叫声\]_ - 是否强制所有LESS/CSS在模块上下文中处理(不只是 `*.module.css` 财务报告和审定财务报表 `*.module.less` 文档).
-   `deep` _\[弦-阵\]_ - 1个或更多JavaScript条件,一旦满足,就表示有深度联系,任何先发制人都应被放弃.
-   `target` _\[弦-阵\]_ - 构建型通用预设字符串(见 `target` [网络软件包选项](https://webpack.js.org/configuration/target/))或以具体方式 [浏览器列表阵列](https://github.com/browserslist/browserslist) 目标.
-   `publicUrl` _\[弦\]_ - 服务或预定托管应用程序的公共路径 URL。 也可以通过软件包设置. json `homepage` 字段.
-   `proxy` _\[弦\]_ - 项目期间的代理目标 `serve` 用于 [http- proxy- middle 软件](https://github.com/chimurai/http-proxy-middleware)。 。 。 .

例如:

```js
{
    ...
    "enact": {
        "theme": "limestone",
        "resolveFallback": {
            fs: false,
            net: false,
            tls: false
        }
    }
    ...
}
```

## 在编辑器中显示 Lint 输出

一些编辑,包括Visual Studio代码,Sublime Text,和Atom为ESLint提供插件.

闪烁时不需要它们。 你该看看终点站的出入口 然而,如果你更喜欢在编辑器中右出彩的结果,你可以做一些额外的步骤.

您需要先为您的编辑器安装一个 ESLint 插件 .

自ESLint 6起,ESLint配置的全球安装不再被支持. 为了绕着这个新的限制而努力,同时仍然支持收编倒行走,我们创造了一个新的 [eslint - 配置 - 代理服务器](https://github.com/enactjs/eslint-config-enact-proxy) 软件包. 这个 [eslint - 配置 - 代理服务器](https://github.com/enactjs/eslint-config-enact-proxy) 动作像一个小代理配置,将ESLint重定向到使用全球安装的Privator ESLint配置. `eslint-config-enact-proxy` 需要安装在本地的一个项目上, 以便允许内接编辑:

```sh
npm install --save-dev eslint-config-enact-proxy
```

而且,你需要修改 `eslintConfig` 属性在 `package.json`数字 :

```json
  "eslintConfig": {
    "extends": "enact-proxy"
  },
```

> **页:1**: 对于严格模式,使用 `"extends": "enact-proxy/strict"`。 。 。 .

为了让内地编辑林特配合我们更新的ESLint配置,你需要升级到ESLint 7或稍后. 可通过运行在全球安装:

```sh
npm install -g eslint
```

然后,您需要解开任何先前在全球安装的 普林特嵌入软件包(除了斯林特本身之外的一切):

```sh
npm uninstall -g eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-babel @babel/eslint-parser eslint-plugin-jest eslint-plugin-enact eslint-config-enact
```

## 文档

-   [制定CLI开发工具](https://enactjs.com/docs/developer-tools/cli/)

## 版权和许可证信息

除非另有说明,本寄存器中的所有内容,包括所有源代码文件和文档文件为:

版权(c)2016-2025 LG 电子

根据 Apache 许可证, 版本 2. 0 (“ License ”) 获得许可; 您不能使用此文件, 除非符合许可证 。 您可在下列地点获得许可证副本:

[http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )](http://www.apache.org/licenses/LICENSE-2.0)

除非适用的法律要求或书面同意,根据许可证分发的软件在 " AS IS " BASIS上分发,没有任何明示或默示的WARANTIES或CONDITION。 见《许可证》关于许可和许可证限制的具体语言.

这个项目的部分依据是: [创建- 反应- 应用程序](https://github.com/facebookincubator/create-react-app),版权(C)2016年至今 Facebook, Inc.

## 常见问题

### @enact/cli 是什么？

用于发布应用程序的全特有建筑环境工具\.

### 如何安装 @enact/cli？

在项目目录运行 npm install @enact/cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@babel/core（^8\.0\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 enact，可以用 npx enact 直接运行。

### @enact/cli 支持 TypeScript 吗？

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

### @enact/cli 支持 ESM 还是 CommonJS？

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

### @enact/cli 需要什么版本的 Node\.js？

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

### @enact/cli 可以商用吗？

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

### @enact/cli 的下载量有多少？

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

### @enact/cli 还在维护吗？

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