Skip to content
导航栏

配置 - 显示相关

messages

  • 描述 : 自定义命令行提问信息
  • 例子 :
json
{
  "messages": {
    "type": "Select the type of change that you're committing:",
    "scope": "Denote the SCOPE of this change (optional):"
    // ...
  }
}
{
  "messages": {
    "type": "Select the type of change that you're committing:",
    "scope": "Denote the SCOPE of this change (optional):"
    // ...
  }
}

themeColorCode

  • 描述 : 设置终端交互部件的主题色
  • 类型 : string
  • 默认 : "" (⇒ cyan 青色)

TIP


  • 使用 256 Color

  • 使用 256 RGB Color (不推荐使用在团队项目中使用,需要终端支持,兼容性较差)


如果你不想要采用配置记录的主题色,可以在~/.bashrc 或者 ~/.zshrc 等 profile 文件中添加一行,其优先级会更高:

sh
export ___X_CMD_THEME_COLOR_CODE="38;5;043"
export ___X_CMD_THEME_COLOR_CODE="38;5;043"

types

  • 描述 : 自定义选择类型提示
  • 类型 : Array<{ name: string; value: string; emoji?: string }>
  • 例子 :
    types: [{value: 'feat', name: 'feat: 新增功能 | A new feature', emoji: ':sparkles:'}]

TIP

如果要使用 Emoji 需要 开启 userEmoji 配置项。
并且需添加 Emoji Code,可以在: https://gitmoji.dev/emoji-cheat-sheet 查找相应的字符进行补充到 emoji

useEmoji

  • 描述 : 是否开启 commit message 带有 Emoji 字符。
  • 类型 : boolean
  • 默认 : false

TIP

尝试运行命令 可在当前会话直接开启输出 emoji 模式

  • 使用 Commitizen CLI: emoji=1 cz
  • 使用 cz-git CLI: czg emoji

emojiAlign

  • 描述 : 设置 Emoji 字符位于头部位置
  • 类型 : "left" | "center" | "right"
  • 默认 : "center"
  • 示例 : <left> type(scope): <center> subject <right>

typesAppend

  • 描述 : 在默认 types 的基础上,添加额外的 types
  • 类型 : Array<{ name: string; value: string; emoji?: string }>
  • 使用 : 只想额外添加少量types,不想添加臃肿的默认配置,或改变默认配置的显示顺序时使用。
  • 默认 : []
  • 例子 :
json
{
  "typesAppend": [
    { "value": "workflow", "name": "workflow:  Workflow changes" },
    { "value": "*!", "name": "*!:        BREAKING CHANGES" }
  ]
}
{
  "typesAppend": [
    { "value": "workflow", "name": "workflow:  Workflow changes" },
    { "value": "*!", "name": "*!:        BREAKING CHANGES" }
  ]
}

typesSearchValue

  • 描述 : 默认 types 类别列表的模糊搜索针对列表 value 字段。设置为 false 后针对列表 name 字段
  • 类型 : boolean
  • 默认 : true

scopesSearchValue

  • 描述 : 默认 scopes 范围列表的模糊搜索针对列表 name 字段。设置为 true 后针对列表 value 字段
  • 类型 : boolean
  • 默认 : false

customScopesAlign

  • 描述 : 设置 选择范围 中 为空选项(empty) 和 自定义选项(custom) 的 位置
  • 类型 : "top" | "bottom" | "top-bottom" | "bottom-top"
  • 默认 : "bottom"

customScopesAlias

  • 描述 : 自定义 选择范围 中 自定义选项(custom) 在命令行中显示的 名称
  • 类型 : string
  • 默认 : custom

emptyScopesAlias

  • 描述 : 自定义 选择范围 中 为空选项(empty) 在命令行中显示的 名称
  • 类型 : string
  • 默认 : empty

customIssuePrefixAlign

  • 描述 : 设置 选择 issue 前缀 中 跳过选项(skip) 和 自定义选项(custom) 的 位置
  • 类型 : "top" | "bottom" | "top-bottom" | "bottom-top"
  • 默认 : "top"

customIssuePrefixAlias

  • 描述 : 自定义 选择 issue 前缀 中 自定义选项(custom) 在命令行中显示的 名称
  • 类型 : string
  • 默认 : custom

emptyIssuePrefixAlias

  • 描述 : 自定义 选择 issue 前缀 中 跳过选项(skip) 在命令行中显示的 名称
  • 类型 : string
  • 默认 : skip

confirmColorize

  • 描述 : 确定提交中模板 commit message 是否着色
  • 类型 : boolean
  • 默认 : true




TIP

使用 默认值 可以产生很多种玩法让工具更契合你或团队的习惯,可查看小窍门

defaultType

  • 描述 : 如果 defaultType 与 types 选择范围列表项中的 value 相匹配就会进行星标置顶操作。
  • 类型 : string
  • 默认 : ""

defaultScope

  • 描述 : 如果 defaultScope 与 scopes 选择范围列表项中的 value 相匹配就会进行星标置顶操作。
  • 类型 : string | string[] [...] 在多选模式中会默认选中
  • 默认 : ""
  • 额外 : 在 自定义范围 中是否使用显示默认值

⇒ 查看小窍门

defaultSubject

  • 描述 : 在 简短描述 中是否使用显示默认值
  • 类型 : string
  • 默认 : ""
  • 使用 : 初始化补全模板,可使用 Tab 或者 进行快速补全;亦可直接使用 Enter 输出模板。

⇒ 查看小窍门

defaultBody

  • 描述 : 在 详细描述 中是否使用显示默认值
  • 类型 : string
  • 默认 : ""
  • 使用 : 初始化补全模板,可使用 Tab 或者 进行快速补全;亦可直接使用 Enter 输出模板。

defaultFooterPrefix

  • 描述 : 在 自定义ISSUE前缀 中是否使用显示默认值
  • 类型 : string
  • 默认 : ""
  • 使用 : 初始化补全模板,可使用 Tab 或者 进行快速补全;亦可直接使用 Enter 输出模板。

defaultIssues

  • 描述 : 在 输入ISSUE 中是否使用显示默认值
  • 类型 : string
  • 默认 : ""
  • 使用 : 初始化补全模板,可使用 Tab 或者 进行快速补全;亦可直接使用 Enter 输出模板。

⇒ 查看小窍门

我只是尽力将工具做得更好,如果可以的话欢迎给一个 star ⭐