# @favoloso/conventional-changelog-emoji 中文文档

规范地址：https://npmcn.com/package/%40favoloso/conventional-changelog-emoji/

版本：0\.11\.0
npm 元数据更新时间：2026-10-29T19:00:16.954Z
中文译文更新时间：2026-11-14T12:01:21.257Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：43.7 kB，42 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-02-24T03:25:27.978Z
- 最新版本发布：2026-10-29T19:00:16.717Z
- 近 30 天下载量：3887（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 1 个）

## 中文简介

在Emojis支持下的常规更改日志

## 安装

```sh
npm install @favoloso/conventional-changelog-emoji
```

也可以使用：`pnpm add @favoloso/conventional-changelog-emoji`、`yarn add @favoloso/conventional-changelog-emoji`、`bun add @favoloso/conventional-changelog-emoji`

## README

# @favoloso/常规变换log-emoji

[![CI](https://github.com/favoloso/conventional-changelog-emoji/actions/workflows/ci.yml/badge.svg)](https://github.com/favoloso/conventional-changelog-emoji/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/@favoloso/conventional-changelog-emoji.svg)](https://www.npmjs.com/package/@favoloso/conventional-changelog-emoji)

Emojis 支持的常规更改日志 QQ

软件包没有运行时间依赖性 .

## 所需资源

-   `conventional-changelog` v8+和 (中文(简体) ) `conventional-recommended-bump` 五维+ (即说. [`@release-it/conventional-changelog`](https://github.com/release-it/conventional-changelog) v12+ 和 (简体中文) `release-it` (原始内容存档于2018-09-21). v21+.
-   节点.js v22+(由上述工具要求).

> 旧工具( Handlebars ) `conventional-changelog-writer` v8及以下)由v0.10.x支持.

## 安装

```sh
yarn add --dev @favoloso/conventional-changelog-emoji
```

或者说

```sh
npm install --save-dev @favoloso/conventional-changelog-emoji
```

## 使用量

```sh
conventional-changelog -p @favoloso/emoji -i CHANGELOG.md -s
```

### 用法为 `release-it`

你用得着 [常规变化日志 插件](https://github.com/release-it/conventional-changelog) 与 `@favoloso/emoji` 预设.

```json
"release-it": {
  "plugins": {
    "@release-it/conventional-changelog": {
      "preset": "@favoloso/emoji",
      "infile": "CHANGELOG.md"
    }
  }
}
```

## Lint( 并固定) 发送消息

此软件包提供了额外的 bin 脚本 `emoji-commit-lint`。 。 。 .

脚本 **提示和最终更改**,来自传统常规更改日志 格式(即:. `feat: Add a magic feature`)到相应的emoji(即. `✨ Add a magic feature`, (中文(简体) ), 检查并应用正确的外壳(即:. `lower-case`) 和更多,按配置 以 [**线条规则**](https://github.com/favoloso/conventional-changelog-emoji/wiki/Linter-Rules)。 。 。 .

要使用、安装和初始化 [嘘](https://github.com/typicode/husky)

```sh
yarn add --dev husky
yarn husky init
```

现在添加 `.husky/commit-msg` 钩:

```sh
HUSKY_GIT_PARAMS="$1" npx emoji-commit-lint
```

现在,linter会检查你的承诺。 任何承诺,如 `<type>: <msg>` 将自动 与相关的情感转变。 见 _可用的 Emojis_ 见可用 **类型**。 。 。 .

## 配置

软件包是按原样工作的,但其行为可能按照以下选项定制.

> _说明:_ 配置从当前目录开始搜索到用户家, 地点如下( 第一个发现获胜 ): `favolosoEmoji` 属性在 `package.json`, (中文(简体) ), `.favolosoEmojirc` (杰森语), `.favolosoEmojirc.json`, (中文(简体) ), `.favolosoEmojirc.js`, (中文(简体) ), `favolosoEmoji.config.js`。 。 。 . YAML 文件 (% 1)`.favolosoEmojirc`, (中文(简体) ), `.favolosoEmojirc.yaml`, (中文(简体) ), `.favolosoEmojirc.yml`)不再被支持:请将其转换为JSON.

-   **`emojis`** (默认 : `{}`(中文(简体) )
    
    允许您自定义常规更改类型的对象( 如 _可用的 Emojis_ 页:1.
    
    您应该提供对象, 其中键是 `type` 您想要编辑(或添加),而值是 更新配置。 如果已有配置, 配置将会与正本合并 .
    
    见 [**自定义 Emoji** 维基页面](https://github.com/favoloso/conventional-changelog-emoji/wiki/Custom-Emojis) 详细情况.
    
-   **`rules`** (默认 : `{}`(中文(简体) )
    
    允许自定义linter 规则 . 见 [**线条规则** 维基页面](https://github.com/favoloso/conventional-changelog-emoji/wiki/Linter-Rules) 详细情况.
    
-   **`showEmojiPerCommit`** (默认 : `false`(中文(简体) )
    
    在变更日志中,显示每个承诺的emoji. 在默认模式( E)`false`),将emojis从承诺中省去,只有标题中包含它们(即. `🐛 Bug Fixes`(中文(简体) )
    
-   **`minorForBreakingInDevelopment`** (默认 : `true`(中文(简体) )
    
    开发过程中的突破性变化将被视为 _小声_ 改为 _主要_ 凸起 (参见 [光谱](https://semver.org/#spec-item-4)) (中文(简体) ).
    
    > 4.  主要版本0 (0.y.z)是用于初始开发. 随时都可能改变 公众API不应被视为稳定.
    
-   **`language`** (默认 : `en`(中文(简体) )
    
    允许翻译输入组标题 `CHANGELOG.md` (即说. `🐛 Bug Fixes`)和插件中的信息. 可用语文: `en`, (中文(简体) ), `it`
    

### 软件包中的示例配置

```json
{
  "favolosoEmoji": {
    "showEmojiPerCommit": false
  }
}
```

## 可用的 Emojis

| 爱莫吉 | 别名 | 类型 | 类型异名 | 版本弹出 | 在Changlog吗? | 标题 | 顺序 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 🚨 |  | `breaking` |  | 主要 | ✅ | QQ 中断更改 | 10个 |
| ✨ | 🌟,💫也 | `feat` |  | 小声 | ✅ | \* 特性 | 20国 |
| 🔒 |  | `security` |  | 补丁 | ✅ | • 警卫 | 第25条 |
| 🛠️ |  | `improvement` | `imp` | 补丁 | ✅ | 改进 | 30个 |
| ⚡️ |  | `perf` | `performance` | 补丁 | ✅ | 绩效 | 35个 |
| 🐛 | 🐞 | `fix` |  | 补丁 | ✅ | 错误修正 | 第40条 |
| 📚 | 📖 | `docs` | `doc` | 补丁 | ✅ | 页:1 | 第50条 |
| 🏗️ | ⚙️ | `chore` | `chores` | 补丁 | ✅ | 工作时间 | 页:1 |
| 🎨 | 💄 | `style` | `cleanup` | 补丁 |  | QQ 样式 | 90 (韩语) |
| ♻️ |  | `refactor` |  | 补丁 |  | \* 正在重构 | 90 (韩语) |
| 🚦 | ✅ | `test` |  | 补丁 |  | 测试 | 90 (韩语) |
| 📦 |  | `build` | `deps` | 补丁 |  | QQ 构建 | 90 (韩语) |
| 🔖 |  | `release` |  | 补丁 |  | QQ 发布 | 90 (韩语) |
| 🚧 |  | `wip` |  | 补丁 |  | \\ 维普 | 90 (韩语) |

## 常见问题

### @favoloso/conventional-changelog-emoji 是什么？

在Emojis支持下的常规更改日志

### 如何安装 @favoloso/conventional-changelog-emoji？

在项目目录运行 npm install @favoloso/conventional-changelog-emoji，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 emoji-commit-lint，可以用 npx emoji-commit-lint 直接运行。

### @favoloso/conventional-changelog-emoji 支持 TypeScript 吗？

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

### @favoloso/conventional-changelog-emoji 支持 ESM 还是 CommonJS？

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

### @favoloso/conventional-changelog-emoji 可以商用吗？

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

### @favoloso/conventional-changelog-emoji 的下载量有多少？

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

### @favoloso/conventional-changelog-emoji 还在维护吗？

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