发包流程

伪步骤

1. git add . && git commit -m "feat: add new feature" && git push
2. npm login # 若已登录可跳过
3. npm test && npm run build # 发布前务必构建并检查产物
4. npm version patch --no-git-tag-version # patch/minor/major
4. git add . && git commit -m "chore: v1.0.1" && git push
5. git tag v1.0.1 -m "chore: v1.0.1"
6. git push --follow-tags
7. npm publish --access public

1. 配置 .npmrc 文件（可选）

registry=https://registry.npmjs.org/
git-tag-version=false # 发布时不自动创建 git 标签

详细说明

• registry: 仓库地址，默认是 https://registry.npmjs.org/，可以根据需要修改为其他仓库地址，例如私有仓库。
• git-tag-version: 设置为 false 可以避免在发布时自动创建 git 标签

2. 登录 npm 账号

提示

请先注册好 npm 账号！

# 登录 npm
npm login

# 检查当前登录用户
npm whoami

3. 检查/更新版本（可选）

发布版本前需要先检查当前版本号，若需要更新版本号，可以使用以下命令快速更新：

# 补丁版本，最后一位数加1，例如：v1.0.0 -> v1.0.1
npm version patch
# 增加了新功能 中间的数字加1，例如：v1.0.0 -> v1.1.0
npm version minor
# 大改动,不向下兼容 第一位数字加1，例如：v1.0.0 -> v2.0.0
npm version major

# 预发布版本 alpha，例如：v1.0.0-alpha.0
npm version prerelease --preid=alpha
# 预发布版本 beta，例如：v1.0.0-beta.0
npm version prerelease --preid=beta
# 预发布版本 rc，例如：v1.0.0-rc.0
npm version prerelease --preid=rc
# 预发布版本 next，例如：v1.0.0-next.0
npm version prerelease --preid=next

# 手动更新版本
npm version 1.0.0

4. 更新 CHANGELOG.md（可选）

推荐安装并使用 conventional-changelog：

npm i -D conventional-changelog-cli

package.json 中添加以下脚本：

{
  "scripts": {
    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
    "version": "npm run changelog" // 每次执行 npm version 时会自动更新 CHANGELOG.md
  }
}

当然，也可以使用其他工具或者手动更新 CHANGELOG.md 文件。

5. 发布包

# （可选）查看将要发布的内容
npm publish --dry-run

# 发布包
npm publish