# @adobe/aio-lib-env 中文文档

规范地址：https://npmcn.com/package/%40adobe/aio-lib-env/

版本：3\.0\.1
npm 元数据更新时间：2026-10-01T01:32:27.313Z
中文译文更新时间：2026-11-05T18:19:41.633Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：32.1 kB，21 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2021-03-10T14:38:44.510Z
- 最新版本发布：2024-02-08T14:28:06.826Z
- 近 30 天下载量：80441（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 0 个）

## 中文简介

Adobe I/O lib 用于确定 dev 环境

## 安装

```sh
npm install @adobe/aio-lib-env
```

也可以使用：`pnpm add @adobe/aio-lib-env`、`yarn add @adobe/aio-lib-env`、`bun add @adobe/aio-lib-env`

## README

[![Version](https://img.shields.io/npm/v/@adobe/aio-lib-env.svg)](https://npmjs.org/package/@adobe/aio-lib-env) [![Downloads/week](https://img.shields.io/npm/dw/@adobe/aio-lib-env.svg)](https://npmjs.org/package/@adobe/aio-lib-env) ![Node.js CI](https://github.com/adobe/aio-lib-env/workflows/Node.js%20CI/badge.svg) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Codecov Coverage](https://img.shields.io/codecov/c/github/adobe/aio-lib-env/master.svg?style=flat-square)](https://codecov.io/gh/adobe/aio-lib-env/)

# Adobe I/O 信封列表

这是一个用于 Adobe I/O CLI 和 SDKs 的辅助库,用于确定要运行的环境,是否 `prod`,或 `stage`。 。 。 .

### 安装

```bash
$ npm install @adobe/aio-lib-env 
```

### 使用量

确定环境

```javascript
const { 
  getCliEnv, /* function */ 
  setCliEnv, /* function */
  SUPPORTED_ENVS, /* array<string> */
  DEFAULT_ENV, /* string */
  PROD_ENV, /* string */
  STAGE_ENV /* string */
} = require('@adobe/aio-lib-env')

// getCliEnv defaults to PROD_ENV if the global config key is not set, or is set to an unknown env
const env = getCliEnv() 
// do something based on the env - switch to prod or stage endpoints, for example
```

创造环境(.aio)

```json
{
  cli: {
    env: "prod"
  }
}
```

建立环境(.env)

```ini
AIO_CLI_ENV=prod
```

设置环境( 代码)

```javascript
const { setCliEnv, PROD_ENV, STAGE_ENV } = require('@adobe/aio-lib-env')

setCliEnv(PROD_ENV)
setCliEnv(STAGE_ENV)
setCliEnv('delta-quadrant') // throws Error
```

### 除错日志

```bash
LOG_LEVEL=debug <your_call_here>
```

预留 `LOG_LEVEL` 环境变量和 `debug` 值到引用您函数的调用,在命令行上。 这将为您的 SDK 电话输出大量调试数据 .

### 捐款

欢迎捐款! 读取 [贡献指南](https://npmcn.com/package/%40adobe/aio-lib-env/.github/CONTRIBUTING.md) 更多信息.

### 许可证发放

这个项目根据Apache V2许可证获得许可. 见 [自由主义](https://npmcn.com/package/%40adobe/aio-lib-env/LICENSE) 更多信息.

## 常见问题

### @adobe/aio-lib-env 是什么？

Adobe I/O lib 用于确定 dev 环境

### 如何安装 @adobe/aio-lib-env？

在项目目录运行 npm install @adobe/aio-lib-env，或使用 pnpm add / yarn add / bun add。

### @adobe/aio-lib-env 支持 TypeScript 吗？

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

### @adobe/aio-lib-env 支持 ESM 还是 CommonJS？

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

### @adobe/aio-lib-env 需要什么版本的 Node\.js？

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

### @adobe/aio-lib-env 可以商用吗？

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

### @adobe/aio-lib-env 的下载量有多少？

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

### @adobe/aio-lib-env 还在维护吗？

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