运行工具
本工具专为开发人员设计,用于快速生成符合行业通用规范的 Git 提交信息(Commit Message)。通过结构化的输入界面,您可以轻松定义提交的核心要素,包括选择提交类型(如 feat 表示新功能、fix 表示修复)、指定影响范围(例如 auth 模块或 api 接口)以及填写具体的修改描述。如果您暂时无法提供详细的描述文本,系统支持从内置的专业模板库中随机选取合适的内容,自动组合成完整且语义通顺的提交说明,从而节省构思时间。当您的代码更新涉及不兼容的 API 变更或重大结构调整时,只需启用“破坏性变更”选项,生成的文本末尾便会自动附加标准的 BREAKING CHANGE 标记及三条固定的详细说明行,确保团队成员能清晰识别潜在风险。该功能特别适用于需要严格规范化版本历史记录的开发团队,有助于保持代码库历史的一致性与高可读性,降低协作沟通成本。所有数据处理过程均在您的浏览器本地环境中即时完成。请注意,本工具生成的内容仅为纯文本建议,不会直接与您的代码仓库交互,也不会执行任何 Git 命令。用户需自行检查结果,复制生成的文本,并手动应用于实际的 Git 提交操作中,以确保版本控制的准确性。
使用说明
- 在“提交类型”字段中输入提交类型(例如 feat、fix),留空则随机选择。
- 在“影响范围”字段中输入影响范围(例如 auth、api),留空则随机选择。
- 在“消息描述”字段中输入具体的修改描述,留空则由系统自动生成。
- 若涉及不兼容的 API 变更,请勾选“破坏性变更”复选框。
- 点击运行按钮,查看生成的格式化提交信息。
- 复制结果面板中的文本,粘贴到您的 Git 提交操作中。
示例
- 类型填 feat,范围填 auth,消息填 add login button,不勾选破坏性变更。结果示例:feat(auth): add login button
- 所有文本字段留空,勾选破坏性变更。结果示例:fix(core): update dependency structure\n\nBREAKING CHANGE: ...
- 类型填 docs,范围留空,消息填 update readme。结果示例:docs: update readme
常见问题
如果我不填写任何内容会怎样?
若所有文本字段留空,系统会从内置列表中随机选择类型、范围和消息模板进行组合,生成一个通用的提交信息。
这个工具会直接修改我的 Git 仓库吗?
不会。该工具仅生成文本字符串,不会执行任何 Git 命令,也不会访问或修改您的本地或远程仓库。您需要手动复制生成的文本。
什么是破坏性变更选项?
勾选此选项后,生成的提交信息末尾会追加标准的 BREAKING CHANGE 标记及说明,用于提示下游用户该提交包含不兼容的 API 变更。
生成的提交信息符合 Conventional Commits 规范吗?
工具旨在生成符合常规格式的文本,但不保证完全符合所有严格的规范细节或特定团队的自定义规则。建议在使用前进行检查。