# 0console 中文文档

规范地址：https://npmcn.com/package/0console/

版本：0\.0\.1
npm 元数据更新时间：2022-04-04T10:08:38.085Z
中文译文更新时间：2026-10-31T12:22:15.624Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/0console
原文对照：https://npmcn.com/package/0console/?lang=original
项目主页：https://github.com/simple-works/0console#readme
源码仓库：https://github.com/simple-works/0console

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

- 包体积（解压后）：450 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2022-03-06T06:16:36.744Z
- 最新版本发布：2022-03-06T06:16:36.893Z
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

修复控制台功能，改善输出。

## 安装

```sh
npm install 0console
```

也可以使用：`pnpm add 0console`、`yarn add 0console`、`bun add 0console`

## README

# ✒️0控制台

[![NPM version](https://badge.fury.io/js/0console.svg)](https://npmjs.org/package/0console)

简单的修补控制台功能与改进的输出。

![Screenshot](https://npmcn.com/package/0console/screenshot.jpg?raw=true)

# 📥安装

```
npm i 0console
```

# 🏁使用

使用打补丁的控制台对象：

```js
require("0console").patch();

console.log("Hello World!");
console.log("Highlighted", "Hello World!");
```

不修补控制台对象：

```js
const $console = require("0console");

$console.log("Hello World!");
$console.log("Highlighted", "Hello World!");
```

# ⚙️功能

-   `console.log(...args)` ：写正常消息。
-   `console.info(...args)` ：写提示消息。
-   `console.warn(...args)` ：写警告信息。
-   `console.error(...args)` ：写错误信息。
-   `console.clear(...args)` ：清除输出（与原始不同）。
-   🆕 `console.success(...args)` ：写成功消息。
-   🆕 `console.line(char?, color?, count?)` ：写一条水平线。
    -   `char` ：要重复的文本（一个字符）。
    -   `color` ：控制台中文本的颜色(使用 [粉笔](https://github.com/chalk/chalk)）。
    -   `count` ：重复次数 `char` （线的长度）。

💡如果一个日志函数（log, info, warn, error, success）有多个参数，则第一个参数的文本将在控制台中突出显示。

# ⚙️工艺功能

您可以创建自己的自定义函数：

```js
const $console = require("0console");

const newConsoleInfo = $console.craft(console.info, {
  prefix: { text: "?", color: "cyanBright", bgColor: "bgBlueBright" },
  highlight: { color: "blueBright" },
  normal: { color: "blueBright" },
});
```

-   `console.craft(fn, options?)` ：制作给定控制台功能的补丁版本。
    -   `fn` ：控制台功能的工艺。
    -   `options` ： Options对象。
        -   `prefix` ：描述前缀文本的对象。
            -   `text`：前缀文本。
            -   `color`：前缀的颜色。
            -   `bgColor`：前缀的背景色。
        -   `highlight` ：对象，描述第一个参数的高亮显示文本。
            -   `color`：高亮文字的颜色。
        -   `normal` ：描述正常文本的对象。
            -   `color`：正常文字的颜色。

# 📃许可证

[麻省理工学院](https://npmcn.com/package/0console/LICENSE) © [Ambratolm](https://github.com/Ambratolm)

## 常见问题

### 0console 是什么？

修复控制台功能，改善输出。

### 如何安装 0console？

在项目目录运行 npm install 0console，或使用 pnpm add / yarn add / bun add。

### 0console 支持 TypeScript 吗？

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

### 0console 支持 ESM 还是 CommonJS？

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

### 0console 可以商用吗？

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

### 0console 还在维护吗？

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