# @azerion/bunosaurus-logger 中文文档

规范地址：https://npmcn.com/package/%40azerion/bunosaurus-logger/

版本：4\.0\.1
npm 元数据更新时间：2026-10-18T07:53:16.430Z
中文译文更新时间：2026-11-07T23:33:57.545Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40azerion/bunosaurus-logger
原文对照：https://npmcn.com/package/%40azerion/bunosaurus-logger/?lang=original
项目主页：https://github.com/azerion/bunosaurus#readme
源码仓库：https://github.com/azerion/bunosaurus

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

- 包体积（解压后）：138 kB，21 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-11T14:10:26.731Z
- 最新版本发布：2026-10-18T07:53:16.060Z
- 近 30 天下载量：2039（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

一个封装的记录器,用于模拟控制台信息的格式.

## 安装

```sh
npm install @azerion/bunosaurus-logger
```

也可以使用：`pnpm add @azerion/bunosaurus-logger`、`yarn add @azerion/bunosaurus-logger`、`bun add @azerion/bunosaurus-logger`

## README

# `@docusaurus/logger`

一个封装的记录器,用于模拟控制台信息的格式.

## APIs 密码

它导出一个对象作为默认导出 : `logger`。 。 。 . `logger` 具有下列属性:

-   一些有用的颜色.
    -   `red`
    -   `yellow`
    -   `green`
    -   `bold`
    -   `dim`
-   格式化软件。 这些函数都有签名 `(msg: unknown) => string`. 注意其执行得不到保证。 你应该只关心他们的语义.
    -   `path`:格式化文件路径.
    -   `url`: 格式化一个 URL.
    -   `name`: 格式化一个标识符.
    -   `code`:格式化代码片段.
    -   `subdue`:将文字下接.
    -   `num`:格式为数字.
-   这个 `interpolate` 函数。 这是一个模板字面标记。 语法如下.
-   日志函数 。 所有伐木功能都可以作为正常功能(类似于 `console.log` 家族,但只接受一个参数)或模板字面标记.
    -   `info`:打印信息.
    -   `warn`:打印一个应当注意的警告.
    -   `error`:打印一个显示出重大问题的错误(不一定停止程序).
    -   `success`: 打印成功的信息.
-   这个 `report` 函数。 它需要一个 `ReportingSeverity` 价值(`ignore`, (中文(简体) ), `log`, (中文(简体) ), `warn`, (中文(简体) ), `throw`),并根据严重程度报告信息.

### 说句话 `error` 主题

小心一点 `error` 消息,即使它不挂断程序, 也可能造成混乱。 当用户检查日志并找到 `[ERROR]`即使建筑成功 他们也会认为出事了 少用点.

仅使用 Docusaurus `logger.error` 当在投出错误之前打印信件,或者当用户设定了报告的严重程度时 `onBrokenLink`等,将 `"error"`。 。 。 .

还有, `warn` 财务报告和审定财务报表 `error` 将显示 **整个** 请大家注意 如果您在打印关于错误的大块帮助文本, 请更好地使用 `logger.info`。 。 。 .

### 使用模板字面标记

模板字面标记评价嵌入的模板和表达式. `interpolate` 返回新字符串,而其他日志函数则打印它。 下面是典型的用法:

```js
import logger from '@docusaurus/logger';

logger.info`Hello name=${name}! You have number=${money} dollars. Here are the ${
  items.length > 1 ? 'items' : 'item'
} on the shelf: ${items}
To buy anything, enter code=${'buy x'} where code=${'x'} is the item's name; to quit, press code=${'Ctrl + C'}.`;
```

嵌入式表达式在形式上可选前加一面旗帜 `[a-z]+=` (几个小写字母,后面是等号,直接在嵌入式表达式之前). 如果表达式前没有标出任何旗帜,则以正字印刷出. 否则,它的格式化为一个格式化的:

-   `path=`数字 : `path`
-   `url=`数字 : `url`
-   `name=`数字 : `name`
-   `code=`数字 : `code`
-   `subdue=`数字 : `subdue`
-   `number=`数字 : `num`

如果表达式是数组,则格式化为: `` `\n- ${array.join('\n- ')}\n` `` (注意它会自动得到领先的一行终点). 每位成员都是自行格式化的,而项目符号没有格式化. 因此,你可以看到上面的信息被打印为:

![Some text output in the terminal, containing array, code, name, and number formatting](https://npmcn.com/package/%40azerion/bunosaurus-logger/demo.png)

## 常见问题

### @azerion/bunosaurus-logger 是什么？

一个封装的记录器,用于模拟控制台信息的格式\.

### 如何安装 @azerion/bunosaurus-logger？

在项目目录运行 npm install @azerion/bunosaurus-logger，或使用 pnpm add / yarn add / bun add。

### @azerion/bunosaurus-logger 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @azerion/bunosaurus-logger 支持 ESM 还是 CommonJS？

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

### @azerion/bunosaurus-logger 可以商用吗？

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

### @azerion/bunosaurus-logger 的下载量有多少？

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

### @azerion/bunosaurus-logger 还在维护吗？

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