面试题：Node.js模块打包与npm发布的版本管理

Question

在Node.js模块打包并发布到npm过程中，如何合理地进行版本管理？比如当你修改了模块的功能，修复了一个重要bug，此时应该如何更新版本号，遵循什么规范，并且怎样在发布流程中体现版本的变化？

Answer 1

1. 版本管理规范：

   • 遵循语义化版本号规范（SemVer），格式为 MAJOR.MINOR.PATCH，即 主版本号.次版本号.修订号。
   • 主版本号（MAJOR）：当你做了不兼容的 API 修改时，需要递增主版本号。例如，改变了模块导出的函数签名或数据结构，导致使用该模块的代码无法直接运行，此时主版本号加 1。
   • 次版本号（MINOR）：当你以向后兼容的方式添加了新功能时，递增次版本号。比如在模块中新增了一个函数，同时保持原有的 API 不变，次版本号加 1。
   • 修订号（PATCH）：当你修复了 bug，且没有改变 API 时，递增修订号。例如修复了一个模块内部的逻辑错误，没有影响到对外暴露的接口，修订号加 1。

2. 更新版本号的操作：

   • 当修复了一个重要 bug 时，应递增修订号。假设当前版本号为 1.2.3，修复 bug 后版本号应更新为 1.2.4。
   • 在 package.json 文件中直接修改 version 字段的值。例如：

{
  "name": "your - module - name",
  "version": "1.2.4",
  // 其他字段...
}

3. 在发布流程中体现版本变化：
   • 使用 npm 发布：在项目根目录下执行 npm publish 命令发布到 npm 仓库。npm 会读取 package.json 中的版本号，并将新版本发布。
   • Git 版本控制：建议在更新版本号后，进行一次 Git 提交，并添加有意义的提交信息，如 “Fix important bug, bump version to 1.2.4”。然后可以选择打一个版本标签，例如 git tag -a v1.2.4 -m "Release version 1.2.4"，这样可以更好地标记发布的版本。之后将提交和标签推送到远程仓库。