### ### 安装和配置 Commitizen 的步骤 在 Python 项目中使用 Commitizen 需要依赖 Node.js 环境，因为 Commitizen 是基于 Node.js 构建的工具。以下是安装和配置的具体步骤： 1. **确保安装了 Node.js 和 npm** 在开始之前，需要确认系统中已安装 Node.js 和其包管理工具 npm。可以通过以下命令检查版本： ```bash node -v npm -v ``` 如果未安装，可以从官方源或通过包管理工具进行安装。 2. **全局安装 Commitizen** 使用 npm 命令全局安装 Commitizen 工具，这样可以在任意目录下直接调用 `commitizen` 命令： ```bash npm install -g commitizen ``` 全局安装后，Commitizen 将成为系统中的一个可用命令 [^1]。 3. **初始化 Commitizen 配置** 在项目的根目录下运行以下命令以初始化 Commitizen，并指定使用 `cz-conventional-changelog` 适配器生成符合 AngularJS 规范的提交信息格式： ```bash commitizen init cz-conventional-changelog --save-dev --save-exact ``` 这将自动安装所需的适配器并将其添加到 `package.json` 文件中作为开发依赖项 [^5]。 4. **设置 Git Hook 来验证提交规范** 为了确保每次提交都遵循规范，可以使用 `husky` 库创建 Git 提交钩子（hook），在提交时自动触发 Commitizen 检查机制： ```bash npm install husky --save-dev npx husky install npx husky add .husky/commit-msg 'npx --no-install commitizen --hook "$1"' ``` 此步骤将在 `.husky` 目录下生成一个 `commit-msg` 脚本文件，用于拦截提交信息并验证其格式是否符合预期 [^2]。 5. **使用 Commitizen 提交代码** 配置完成后，可以使用以下命令代替传统的 `git commit` 方式来提交代码： ```bash git add . git cz ``` 此命令将启动交互式界面引导用户填写标准化的提交信息 [^1]。 6. **配置 package.json 中的脚本简化提交流程** 可以在 `package.json` 文件中定义自定义脚本命令，例如： ```json "scripts": { "commit": "git add . && git cz" } ``` 这样可以直接通过 `npm run commit` 执行提交操作，提高工作效率 [^4]。 7. **安装额外的辅助库（可选）** 若希望进一步增强提交流程的功能，例如集成 Lint 工具或跨平台支持，可以考虑安装相关库： ```bash npm i my-commit --save-dev npm i cross --save-dev npm i lint-stage --save-dev ``` 这些库可以帮助实现更复杂的自动化检查逻辑 [^3]。 --- ###