# @expo/cli 中文文档

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

版本：58\.1\.21
npm 元数据更新时间：2026-11-17T12:04:03.785Z
中文译文更新时间：2026-11-17T12:06:00.777Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：3.8 MB，1310 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：61 个
- peer 依赖：expo \*，expo-mcp \*，expo-router \*，react-native \*
- 首次发布：2022-03-23T16:20:49.104Z
- 最新版本发布：2026-11-17T12:04:03.213Z
- 近 30 天下载量：58892669（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：555（近 12 个月 214 个）

## 中文简介

博览会CLI

## 安装

```sh
npm install @expo/cli
```

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

## README

[![Expo CLI](https://npmcn.com/.github/resources/cli-banner.svg)](https://expo.dev/)

为Android, iOS, 和网络构建和运行通用 React Industrial 应用程序的最快方式

[📚 读取文档](https://docs.expo.dev/more/expo-cli/)  二. 支助  [在博客上多学点](https://expo.dev/blog)  二. 支助  [为博览会CLI做出贡献](https://npmcn.com/package/%40expo/cli/#readme-contributing)

[![Discord](https://img.shields.io/discord/695411232856997968.svg?style=for-the-badge&color=5865F2&logo=discord&logoColor=FFFFFF)](https://discord.gg/4gtbPAdpaE)

 [![Expo on X](https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/intent/follow?screen_name=expo)  [![Expo on GitHub](https://img.shields.io/badge/GitHub-222222?style=for-the-badge&logo=github&logoColor=white) ](https://github.com/expo)  [![Expo on Reddit](https://img.shields.io/badge/Reddit-FF4500?style=for-the-badge&logo=reddit&logoColor=white) ](https://www.reddit.com/r/expo/)  [![Expo on LinkedIn](https://img.shields.io/badge/Bluesky-1DA1F2?style=for-the-badge&logo=bluesky&logoColor=white) ](https://bsky.app/profile/expo.dev)  [![Expo on LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=LinkedIn&logoColor=white)](https://www.linkedin.com/company/expo-dev)

如果您喜欢使用此项目, 请确定会主演 GitHub Repo

* * *

这个 `@expo/cli` 软件包是应通过 `expo` 软件包,比如 `npx expo start` (或 `npx expo` 页:1.

```
npx expo
```

> 如果你喜欢使用该项目,请请在博览会GitHub Repo上亮相!

## 设计

这一国家行动倡议的目的如下:

-   作为启动本地开发服务器的最小接口,该服务器可以模拟一个生产EAS Updates服务器. 开发服务器是本地运行时间(Expo Go, Dev Client)和JS Bundler(Metro, Webpack)之间的代理服务器.
    -   为了实现网络安全显示签名,比如AsyncStorage或权限,如果两者都需要https/SSL,我们需要一个经过认证的博览会账户。 这是我们唯一包括认证命令的原因 `login`, (中文(简体) ), `logout`, (中文(简体) ), `whoami`, (中文(简体) ), `register`。标准网络CLI没有认证命令,因为他们要么没有设置https,要么通过软件包模拟 `devcert`。 。 。 .
-   Xcode等各种本土工具的管弦, `Simulator.app`,Android Studio,ADB等让本土建筑尽可能无痛. `run:ios`, (中文(简体) ), `run:android` 命令.
-   执行一个版本 `prebuild` 命令,可以长期可靠地与项目一起工作。 Prebuild就像一个捆绑器 对于本地代码,它生成 **机器人** 财务报告和审定财务报表 **欧斯** 基于工程 Expo 配置的文件夹( X)**应用程序.json**) (中文(简体) ).
    -   `npx expo config` 是辅助工具 `npx expo prebuild` 并用于调试/内测.
-   正在安装版本库 `npx expo install` 这是纯粹出于必要性而诞生的最低限度的用途,因为在React Industrial的版本很难正确.

# 捐款

开发 CLI 运行( 默认监视模式) :

```
pnpm build
```

我们强烈建议为博览会的CLI设置一个化名,这样你就可以在电脑周围的项目中尝试. 打开你的 **.zshrc (英语)** 或其他配置文件并添加:

```
alias nexpo="/path/to/expo/packages/@expo/cli/build/bin/cli"
```

那就用这个 `nexpo` 喜欢 `nexpo config`。也可以设置调试版本 :

```
alias expo-inspect="node --inspect /path/to/expo/packages/@expo/cli/build/bin/cli"
```

那样你就可以运行它和参观 `chrome://inspect/#devices` 在克罗姆语中,并按下 **"打开专用的 DevTools 为节点"** 以获取一个调试器附于您的进程。 调试 CLI 时, 您会希望尽可能使工人禁用, 这将让所有代码运行在同一线索上, 这主要适用于 `start` 命令,即:. `expo-inspect start --max-workers 0`。 。 。 .

## 格式

-   一定要更新 [`CHANGELOG.md`](https://npmcn.com/package/%40expo/cli/CHANGELOG.md) 每个公关都会有变化。 您只需要添加消息, 我们的 GitHub bot 会自动建议在 diff 中添加您的姓名和 PR 编号 .
-   结束 `async` 函数与 `Async` 喜欢 `runAsync`。这就是我们在世博会上的功能格式.
-   丢出错误时, 总是选择 `CommandError` 改为 `Error` 这有助于调试,使经验更加一致.
-   利用统一的 `Log` 模块代替 `console.log`。 。 。 .
-   在使用变量进行记录时,使用以下格式 `Something happened (foo: bar, baz: foz)`。 。 。 .
    -   避免其他格式,如 `Something happened: bar, foz` 或者说 `Something happened: foo=bar, baz=foz`。 。 。 .
-   命令名称等主要 UI 组件(`expo start`),论据(`--port`),以及 `--help` 电文应在内部修改,由博览会团队负责,以确保开发者的经验在整个博览会工具中统一。 修改这些核心方面的外部捐款可能遭到拒绝.
-   使用 `profile` 与该工具的通用方法 `EXPO_PROFILE=1` 用于测量执行时间的环境变量.
-   避免全球性的和单子的试验,因为这些使试验更难,更不可预测。 我们(在编写本报告时)唯一的全球问题是: `isOffline` 布尔.

## 环境

-   始终小心依赖的过渡性大小. [软件包恐惧症](https://packagephobia.now.sh/) 用于确定软件包是否精益求精。 尽量减少CLI的依赖性.
-   我们利用 `taskr` + 键 `swc`,这个部分灵感来自Next.js的本地CLI.
-   建设管道将把CLI版本内置为环境变量,在CLI代码库的任何地方都可以访问. 你可以通过 `process.env.__EXPO_VERSION` 而不是读取本地 `package.json` 在运行时间.
-   与传统全球博览会CLI不同的是,这种CLI是和 `expo` 表示 SDK 版本始终存在 .
    -   减少 SDK 特定任务,因为只有一个 SDK 应计入一个版本 `@expo/cli`。 。 。 .
    -   这个 `@expo/config` 方法 `getConfig` 无需 `skipSDKVersionRequirement` 在任何情况下,自从 `expo` 应始终安装。 实例: `getConfig('...', { skipSDKVersionRequirement: true });` 不应该被使用.
-   另外,与全球博览会CLI不同,我们可以假设,节点模块总是安装的,因为这个CLI应该通过项目的地方使用 **节点( 模块)** 文件夹.
    -   这意味着我们无法进行升级操作 `expo` 软件包,因为这些软件包可能会杀死运行的过程。 需要此模式的特征( 如 `expo upgrade`(a) 应在独立的全球工具中生活.

## 测试

有三种测试脚本:

-   `pnpm test`: 受控单位和集成测试
-   `pnpm test:e2e`: 结束对 CLI 命令的测试
-   `pnpm test:playwright`: 以 CLI 结束对 Expo SDK 的测试

* * *

-   您可以使用 `--watch` 旗帜。 示例 `pnpm test --watch config`。 。 。 .
-   我们用回扣 `it` 块。 示例 ``it(`works`)``。 。 。 .
-   如果拉动请求完全自成一体 `packages/@expo/cli/` 文件夹( 即无) `pnpm-lock.yaml` 然后大多数本地CI测试会被跳过,使CI在PRs中通过得更快.

### 单位测试准则

-   使用 `nock` 用于网络请求.
-   无顶级 `describe` 块将所有测试包入文件.
-   测试函数时,将函数传递到 `describe` 块而不是字符串函数名 :
    -   `describe(foobar, () => {})` 改为 `describe('foobar', () => {})`
-   使用虚拟 `fs` 通过 `memfs` 只要可能,就应该.
-   我们有很多全球模块 [**模拟**](https://npmcn.com/package/%40expo/cli/jest.setup.ts) 已经设置了, 在撰写测试时考虑它们 .
-   GitHub 副驾驶可以让写作测试少一点乏味.

### E2E 测试准则

-   E2E测试应具有弹性和可靠性,确保为网络请求留出充足的时间.
-   在本地测试时,你必须 [安装了套装](https://bun.sh/docs/installation)。 。 。 .
-   当本地测试时, 您应该尝试重用节点模块, 以获得更快的结果 。 在那个 `npx expo prebuild` 财务报告和审定财务报表 `npx expo start` 例如,我们使用一种默认重用项目+的帮助方法 **节点( 模块)** 当运行本地。 这可能是 [已切换](https://github.com/expo/expo/blob/11a5a4d27b7e1c8e4d6ddf0401397d789d89f52a/packages/%40expo/cli/e2e/__tests__/utils.ts#L174) {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}每一次 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}把新项目绑起来.
-   拖曳测试项目时,请使用临时文件夹 `os.tmpdir()` 当计算机重新启动时,此文件夹会自动清理.

## 来自博览会CLI

> TL; 大卫: `expo-cli` 是"让它工作",而 `@expo/cli` 是"做对了,快点".

全球遗产 `expo-cli` 软件包被折旧为赞成此版本 `@expo/cli` 软件包,原因如下:

-   `expo-cli` 太大了 安装得太久了 这使得CI沮丧地建立起来,因为你还需要瞄准用于缓存的全球节点模块.
-   `expo-cli` 几乎所有版本的 `expo` 软件包,意思是每次发行都变得更加复杂.
-   `expo-cli` 合并服务命令( 如 遗留 ) `build`, (中文(简体) ), `submit`, (中文(简体) ), `publish`),项目级命令类似 `expo start`我们从此将服务分为 `eas-cli` 命令输入 `npx expo` (单位:千美元)`@expo/cli`) (中文(简体) ). 这种结构对于开发者来说更为优化/快,因为他们可以在需要时安装/更新命令.
-   这种CLI使用更多的Node.js标准特性,例如: `$EDITOR` 而不是习惯 `$EXPO_EDITOR` 环境变量。 也正在从 `$EXPO_DEBUG` 更接近于 `$DEBUG=expo:*`。这些类型的修改使得 Expo CLI 与现有工具玩得更好.
-   DevTools UI已经被去皮化,以减少网络安装大小,将复杂度最小化,并为未来的调试UIs(Hermes/v8 Chrome debuger)留有空间.
-   这个 `expo start:web` 财务报告和审定财务报表 `expo web` 命令已被滚入 `npx expo start` 现在我们懒散地装入平台,直到设备要求它们.
-   其他缺失或β特征来自 `expo-cli` 可能还是被迁移到这个新的CLI。 更详尽的细目,见 [启动命令 PR](https://github.com/expo/expo/pull/16160)。 。 。 .

## 常见问题

### @expo/cli 是什么？

博览会CLI

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

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

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

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

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

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

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

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

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

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

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

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

