Windows下安装commitizen插件

要点简介

一. Commitizen

1. 什么是nvm、npm以及Nodejs

• nvm是nodejs version manage，即nodejs版本管理工具，一个nvm可以管理很多node版本以及npm版本
• nodejs是一个基于chrome v8引擎的Javascript 运行环境
• npm是nodejs包管理工具，用于管理nodejs的第三方插件
• 三者之间的关系为：nvm管理nodejs和npm的版本，npm管理nodejs的第三方插件，如下图所示

安装过程

一.安装说明

1. 根据要点简介里的内容，我们现在清楚了commitizen是nodejs下的一个第三方插件，并不是git提供的插件；commitizen需要在nodejs环境下才能正常运行
2. 所以依据之前我们所了解的nvm、nodejs以及vpm之间的关系，可知需要安装的程序有两个，一个是nvm，另一个为nodejs(其中已包含npm)
3. 但是根据我在安装过程中的测试来看，在实际操作时只需要安装nodejs便可，nvm未安装不会影响插件的使用

二.安装步骤

1. 安装nodejs

• nodejs官网：https://nodejs.org/en/
• 安装过程

• 检查配置

• 配置无误便可进行下一步安装，若没有以上环境变量的配置则可自己手动配置，或者重新安装；注意：该配置很重要，如果未配置则会导致在shell中无法使用node、npm等命令

2. 方法一：直接安装git-cz(安装后便可以直接使用)

3. 方法二：安装commitizen(需要再安装changelog以及在使用时需要进行初始化)

• 检查
  • node -v：查询nodejs版本
  • npm -v：查询npm版本

• 更新npm(不更新则无法显示commitizen插件的安装状态)
  • npm install npm -g：更新npm版本
  • npm ls -g -depth=0：查询插件安装状态(图中写错，是npm，不是nm)

• 安装commitizen
  • npm install commitizen -g：安装commitizen(图中写错，是npm，不是nm)
  • npm ls -g -depth=0：查询插件安装状态

• 安装changelog
  • npm install conventional-changelog -g
  • npm install conventional-changelog-cli -g：安装changelog插件
  • npm ls -g -depth=0：查询插件安装状态

5. 使用commitizen

• 进入git项目所在文件夹进行commitizen初始化(使用git bash)
  • npm init --yes：生成package.json文件
  • commitizen init cz-conventional-changelog --save --save-exact：生成package-lock.json文件以及node——modules文件夹
• 通过git bash使用git cz时可以输入选项名称的方式来选择选项
• 如觉得不便，可使用powershell，其可以通过上下移动来进行选择

• git cz提交(使用powershell)
  • git cz：调用commitizen进行提交

三.git cz简介

四.注意事项

1. nodejs最好按默认安装路径安装到系统盘(C盘)，因为不管nodejs安装在哪个盘，在使用npm命令行安装第三方插件时其都会把插件安装到系统盘，所以为了统一便使用默认安装路径
2. commitizen初始化时应使用git bash，不能使用powerbash，否则会出错，如下图

• 解决办法：以管理员身份运行powershell，执行以下命令
  • set-ExecutionPolicy RemoteSigned：更改执行策略

3. 使用git cz提交时应使用powershell进行上下选择；若使用git bash便只能通过输入选项名称来进行选择，如下图