# @bb-cli/bb-config 中文文档

规范地址：https://npmcn.com/package/%40bb-cli/bb-config/

版本：2\.2\.0
npm 元数据更新时间：2022-07-20T12:50:25.546Z
中文译文更新时间：2026-11-07T21:31:13.150Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40bb-cli/bb-config
原文对照：https://npmcn.com/package/%40bb-cli/bb-config/?lang=original

弃用说明：This package has been deprecated\.Package is no longer supported\. Use at your own risk\.

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

- 包体积（解压后）：63.8 kB，24 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2017-02-28T15:30:25.874Z
- 最新版本发布：2019-03-06T11:04:23.771Z
- 近 30 天下载量：2415（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 0 个）

## 中文简介

获取 bb 工程或全局选项

## 安装

```sh
npm install @bb-cli/bb-config
```

也可以使用：`pnpm add @bb-cli/bb-config`、`yarn add @bb-cli/bb-config`、`bun add @bb-cli/bb-config`

## README

# 名称

bb-配置 - 获取 bb 项目或全局选项

# 叙利亚

```bash
bb-config [--help] [-v|--version]
bb-config files [--help] [-f|--format <format>]
bb-config list [--help]
```

# 解释

要保存用于 bb- cli 工具的多个配置, 配置 可在.bbconfig文件中保存.

当 bb- cli 命令运行时, 选项取自当前选中的 配置 .

# 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-v, --version (英语) | 输出版本编号 |
| \-- 帮助 | 产出使用信息 |

# 指挥

## 名称

bb-config 文件 - 列出 BB CLI 配置文件

## 叙利亚

```bash
bb-config files [--help] [-f|--format <format>]
```

## 解释

.bbconfig 文件是通过合并多个配置获得的,由 这一重要顺序:

-   本地文件: . bbconfig 位于当前工作目录 - 不是父目录
-   全局: . bbconfig 文件位于用户主文件夹 (~)

## 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-f, --format "格式" | 输出格式( 支持的选项: json) |
| \-- 帮助 | 产出使用信息 |

## 实例

列表配置文件 :

```bash
  $ bb-config files
```

## 名称

bb-config 列表 - 列出 BB CLI 配置数据

## 叙利亚

```bash
bb-config list [--help]
```

## 解释

此命令将显示 JSON 中的当前配置数据 格式.

通过合并全球和本地配置获得配置 文件(参见bb-config-files).

配置文件是 JSON 格式化文件, 有相应的根密钥名 改为配置.

可添加 CLI 命令部分, 这些选项将仅适用于这些 命令。 在命令部分中,您也可以添加子命令部分,以及 这些选项将仅适用于子命令.

## 模拟冲突

在这个例子中,命令"bb-serve project"将加载端口和插件选项. 但指挥 "bb-serve foo"只装入"port"选项. 两个命令都会装入"portal-host"和"portal-port" 属性.

```json
{
  "default": {
    "portal-host": "my.portal.com",
    "portal-port": 80
  },
  "dev": {
    "portal-host": "192.168.99.100",
    "portal-port": 8080,
    "serve": {
      "port": 80,
      "project": {
        "plugins": "sass"
      }
     }
  }
}
```

## 名称说明

BB CLI 支持存储在配置文件中的命名配置文件 。 您可以配置额外的 配置文件,将条目添加到配置文件中。 默认情况下, 所有配置值将被取入 从“ 默认” 配置文件.

要在命令行使用一个命名的配置文件设置 BB PROFILE 环境变量 .

## 实例

列出默认配置文件的当前配置 :

```bash
  $ bb-config list
```

Dev 配置文件的列表配置 :

```bash
  $ BB_PROFILE=dev bb-config list
```

## 环境变量

所有 CLI 装入配置时将使用的配置文件

```bash
BB_PROFILE=default
```

# 环境变量

设置日志输出量

```bash
LOG_LEVEL=silly|verbose|info|warn|error
```

设定是否在输出中使用颜色

```bash
COLOR=false|true
```

## 常见问题

### @bb-cli/bb-config 是什么？

获取 bb 工程或全局选项注意：该包已被作者标记为弃用——This package has been deprecated\.Package is no longer supported\. Use at your own risk\.

### 如何安装 @bb-cli/bb-config？

在项目目录运行 npm install @bb-cli/bb-config，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bb-config，可以用 npx bb-config 直接运行。

### @bb-cli/bb-config 支持 TypeScript 吗？

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

### @bb-cli/bb-config 支持 ESM 还是 CommonJS？

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

### @bb-cli/bb-config 可以商用吗？

@bb-cli/bb-config 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @bb-cli/bb-config 的下载量有多少？

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

### @bb-cli/bb-config 还在维护吗？

最新版本 2\.2\.0 发布于 2019/03/06（7 年前）；至今共发布 7 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/02/28。作者已将其标记为弃用，新项目建议寻找替代方案。