# @articulate/progress 中文文档

规范地址：https://npmcn.com/package/%40articulate/progress/

版本：0\.0\.1
npm 元数据更新时间：2024-04-24T15:53:15.780Z
中文译文更新时间：2026-11-07T08:06:39.430Z
软件包许可：MIT

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

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

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

- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2017-11-15T20:33:50.204Z
- 最新版本发布：2017-11-15T20:33:50.204Z
- 近 30 天下载量：1996（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

廉价、实用、终端进度栏

## 安装

```sh
npm install @articulate/progress
```

也可以使用：`pnpm add @articulate/progress`、`yarn add @articulate/progress`、`bun add @articulate/progress`

## README

# @ articulate/ 进步

[![@articulate/progress](https://img.shields.io/npm/v/@articulate/progress.svg)](https://www.npmjs.com/package/@articulate/progress) [![Build Status](https://travis-ci.org/articulate/progress.svg?branch=master)](https://travis-ci.org/articulate/progress) [![Coverage Status](https://coveralls.io/repos/github/articulate/progress/badge.svg?branch=master)](https://coveralls.io/github/articulate/progress?branch=master) [![NSP Status](https://nodesecurity.io/orgs/articulate/projects/172aa9db-55a1-4f0d-b76e-2408bf81d4fa/badge)](https://nodesecurity.io/orgs/articulate/projects/172aa9db-55a1-4f0d-b76e-2408bf81d4fa)

![@articulate/progress](https://user-images.githubusercontent.com/888052/32856962-53142736-ca14-11e7-8296-90160a1fa221.gif)

廉价,功能性,终端进度栏.

下次你又想这样 `process.stderr.write('.')` 来跟踪脚本的进展... 不要. 用这个代替.

## API 密码

```haskell
progress : Object -> Number -> ()
```

要设置进度栏,请使用可选选项对象执行模块:

```js
const progress = require('@articulate/progress')({ /* options here */ })
```

接受以下选择:

| 名称 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `label` | `String` | `'progress'` | 进度栏的自定义标签 |
| `stream` | `stream.Writable` | `process.stderr` | 进步输出流 |
| `width` | `Number` | `24` | 条的最大宽度 |

返回函数接受在 `0` 财务报告和审定财务报表 `1`,并将进度栏写入输出流。 每次被调用时,它都会覆盖之前的进度状态来出现在控制台上.

```js
const progress = require('@articulate/progress')()

progress(0.55)
//> progress: ⣠ [==============          ] 55%
```

见 [`demo.js`](https://github.com/articulate/progress/blob/master/demo.js) 一个比较复杂的例子.

## 常见问题

### @articulate/progress 是什么？

廉价、实用、终端进度栏

### 如何安装 @articulate/progress？

在项目目录运行 npm install @articulate/progress，或使用 pnpm add / yarn add / bun add。

### @articulate/progress 支持 TypeScript 吗？

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

### @articulate/progress 支持 ESM 还是 CommonJS？

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

### @articulate/progress 可以商用吗？

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

### @articulate/progress 的下载量有多少？

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

### @articulate/progress 还在维护吗？

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