@favoloso/conventional-changelog-emoji

中文文档
0.11.0发布于 2026/10/30MITCommonJS零依赖近 30 天下载 3887

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

中文使用文档
文档目录8 节
  1. 所需资源
  2. 安装
  3. 使用量
  4. 用法为 release-it
  5. Lint( 并固定) 发送消息
  6. 配置
  7. 软件包中的示例配置
  8. 可用的 Emojis

@favoloso/常规变换log-emoji

CI npm

Emojis 支持的常规更改日志 QQ

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

所需资源

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

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

安装

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

或者说

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

使用量

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

用法为 release-it

你用得着 常规变化日志 插件 与 @favoloso/emoji 预设.

"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) 和更多,按配置 以 线条规则。 。 。 .

要使用、安装和初始化 嘘

yarn add --dev husky
yarn husky init

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

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 维基页面 详细情况.

  • rules (默认 : {}(中文(简体) )

    允许自定义linter 规则 . 见 线条规则 维基页面 详细情况.

  • showEmojiPerCommit (默认 : false(中文(简体) )

    在变更日志中,显示每个承诺的emoji. 在默认模式( E)false),将emojis从承诺中省去,只有标题中包含它们(即. 🐛 Bug Fixes(中文(简体) )

  • minorForBreakingInDevelopment (默认 : true(中文(简体) )

    开发过程中的突破性变化将被视为 小声 改为 主要 凸起 (参见 光谱) (中文(简体) ).

    1. 主要版本0 (0.y.z)是用于初始开发. 随时都可能改变 公众API不应被视为稳定.
  • language (默认 : en(中文(简体) )

    允许翻译输入组标题 CHANGELOG.md (即说. 🐛 Bug Fixes)和插件中的信息. 可用语文: en, (中文(简体) ), it

软件包中的示例配置

{
  "favolosoEmoji": {
    "showEmojiPerCommit": false
  }
}

可用的 Emojis

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

版本与发布记录

@favoloso/conventional-changelog-emoji 共发布 13 个版本,首次发布于 2019/02/24;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.11.0latest2026/10/3015 天前
0.10.02019/10/247 年前
0.9.02019/03/027 年前
0.8.02019/03/027 年前
0.7.02019/02/277 年前
0.6.02019/02/267 年前

关于 @favoloso/conventional-changelog-emoji 的常见问题

@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 和提交记录判断。