@cenk1cenk2/cz-cc

中文文档
3.0.12发布于 2026/11/04MITCommonJS近 30 天下载 3432

遵循常规更改log格式提交适配器.

中文使用文档
文档目录8 节
  1. 说明
  2. 使用量
  3. 配置
  4. 软件包.json
  5. 环境变量
  6. 中断更改
  7. 迁移到 v3
  8. 委员会

@cenk1cenk2/cz-cc

pipeline status Version Downloads/week Dependencies semantic-release

Demo

说明

这是直接的叉子 cz- 常规变化日志时,它交换 inquirer 页:1 enquirer 以输入类型,并减少总的问题,使许多问题成为可选的.

使用量

  • 安装承诺。 要么在全球范围内,要么在项目中.
# yarn
yarn global add commitizen
# npm
npm install -g commitizen
  • 在工程中启动这个适配器 。 如果已经启动, 您可以添加 --force 旗下可以将这个适配器和旧的相换.
    • 目前工作空间有问题 commitizen。 。 。 .
# yarn
commitizen init @cenk1cenk2/cz-cc --yarn --dev
# npm
commitizen init @cenk1cenk2/cz-cc --dev
  • 添加 git- hooks 为 小时。 。 。 .
amends "package://github.com/jdx/hk/releases/download/v2.0.1/[email protected]#/Config.pkl"

hooks {
  ["prepare-commit-msg"] {
    steps {
      ["commitizen"] {
        fix = "git cz --hook"
        interactive = true
      }
    }
  }
}
  • 添加 承诺 如果需要的话.

配置

利用全球承诺安装安装适配器.

下面是配置设置 .

软件包.json

与承诺式一样,您通过包指定了cz-常规切换log的配置. 强森的 config.commitizen 键.

{
// ...  default values
    "config": {
        "commitizen": {
            "path": "./node_modules/@cenk1cenk2/cz-cc",
            "preset": "conventionalcommits",
            "maxHeaderWidth": 100,
            "maxLineWidth": 100,
            "defaultType": "",
            "defaultScope": "",
            "defaultSubject": "",
            "defaultBody": "",
            "defaultIssues": "",
            "types": {
              ...
              "feat": {
                "description": "A new feature",
                "title": "Features"
              },
              ...
            }
        }
    }
// ...
}

preset 选择断开更改是如何被提示和渲染的, 或 conventionalcommits (违约)或 angular。见 中断更改。 。 。 .

环境变量

以下的环境可流体可以用来覆盖任何默认配置或包. json基于配置.

  • CZ PRESET = 预设
  • CZ TYPE = 默认类型
  • CZ SCOPE = 默认范围
  • CZ SUBJECT = 默认对象
  • CZ BODY = 默认的Body
  • CZ MAX HEADER WIDTH = 最大页眉宽度
  • CZ MA LINTH = 最大线网

中断更改

突破性变化通过快速和 preset 组合决定提供两种机制中的哪一种。 它必须与发布工具分析的预设相匹配.

  • conventionalcommits (单位:千美元)默认二者兼具. breaking-marker 附加 ! 如 feat(api)!: drop the legacy token endpoint,以及 breaking-changes 附录a BREAKING CHANGE 脚指. 规格将两者视为独立的信号,因此任何一个单独标出承诺即为破解并选择两者都是有效的.
  • angular 提议 breaking-changes 一个人,因为 ! 标记不是其头图案的一部分。 这是每一次发布在v3之前的行为.

选择既不离开承诺的不突破,所以普通的承诺仍然在一次通过中跳过整个主题.

迁移到 v3

conventionalcommits 成为 v3 中的默认, 因此通过适配器所做的承诺现在可以携带 ! 在页眉中标记一次 breaking-marker 已选定。 有两件事要查:

  • 释放工具必须分析与 conventionalcommits 预设,否则 ! 标记不读取为大起落. @semantic-release/commit-analyzer 财务报告和审定财务报表 commitlint 都拿一个 preset 他们自己的.
  • header-max-length 计算额外字符,任何工具匹配自定义正则表达式的 承诺信头必须允许 ! 在结肠之前.

为了保持先前的行为, 将预设后置 :

{
  config: {
    commitizen: {
      preset: 'angular'
    }
  }
}

委员会

如果使用 承诺 js 库,"maxheaderWidth"配置属性将默认为"header-max-长"规则的配置,而不是100的硬码值. 这可以通过设置宏包中的"maxheaderWidth"配置来覆盖.json或CZ MA HEADER WIDTH环境变量.

版本与发布记录

@cenk1cenk2/cz-cc 共发布 145 个版本,首次发布于 2020/07/26;过去 12 个月发布了 42 个版本。

版本发布日期距今
3.0.12latest2026/11/045 天前
3.0.112026/10/3010 天前
3.0.92026/10/2119 天前
3.0.102026/10/2119 天前
3.0.82026/10/1822 天前
3.0.72026/10/1822 天前

关于 @cenk1cenk2/cz-cc 的常见问题

@cenk1cenk2/cz-cc 是什么?

遵循常规更改log格式提交适配器.

如何安装 @cenk1cenk2/cz-cc?

在项目目录运行 npm install @cenk1cenk2/cz-cc,或使用 pnpm add / yarn add / bun add。

@cenk1cenk2/cz-cc 支持 TypeScript 吗?

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

@cenk1cenk2/cz-cc 支持 ESM 还是 CommonJS?

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

@cenk1cenk2/cz-cc 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cenk1cenk2/cz-cc 可以商用吗?

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

@cenk1cenk2/cz-cc 的下载量有多少?

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

@cenk1cenk2/cz-cc 还在维护吗?

最新版本 3.0.12 发布于 2026/11/04(5 天前);至今共发布 145 个版本,其中过去 12 个月发布了 42 个;首次发布于 2020/07/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。