使用npm publish时，如何回退至指定旧版本发布npm包？

我之前也碰到过类似的情况——为了测试打了一堆没必要的补丁版本，后来想回退却发现目标版本已经存在。先明确核心规则：npm不允许直接覆盖已发布的版本（这是为了保障依赖生态的稳定性），所以得根据你的实际情况选合适的处理方式：

方案一：删除冗余补丁版本（仅限特定场景） #

如果那些冗余的补丁版本发布时间不超过24小时，且没有其他公共包依赖它们，你可以先清理这些无效版本，再重新发布目标版本：

1. 删除npm上的冗余版本
   打开终端，逐个删除不需要的补丁版本：

   npm unpublish your-package-name@1.0.14
   npm unpublish your-package-name@1.0.15
   # 依次删除所有你认为冗余的版本
   

   注意：如果版本发布超过24小时，npm会阻止删除操作；如果有其他包依赖该版本，也无法删除。这种情况下直接看方案二。

2. 回退本地代码到目标版本
   用git把代码切换到v1.0.13对应的状态：

   # 有标签的话直接 checkout 标签
   git checkout v1.0.13
   # 没有标签的话，用对应提交的hash值
   git checkout <commit-hash-of-v1.0.13>
   

3. 重新发布目标版本
   确认本地代码是v1.0.13的状态，且package.json里的版本号为1.0.13，然后执行发布：

   npm publish
   

方案二：基于旧版本代码发布新的版本号（通用安全方案） #

如果无法删除冗余版本，最稳妥的方式是给旧版本代码打一个全新的版本号发布，同时明确告知版本变更：

1. 回退本地代码到目标版本
   和方案一一样，先把代码切换到v1.0.13的状态：

   git checkout v1.0.13
   

2. 更新版本号
   打开package.json，把版本号改成一个未发布过的新号。比如之前冗余版本到v1.0.15，你可以选择：

   • 语义化补丁版本：1.0.16（适合小范围回退）
   • 小版本号：1.1.0（如果回退涉及重要功能恢复）
     也可以用预发布版本（比如1.0.13-rev1），但更推荐遵循语义化版本规范的前者。

3. 更新CHANGELOG（关键步骤）
   在你的CHANGELOG文件里清晰说明这个版本的定位，避免用户混淆：

   ## 1.0.16 (202X-XX-XX)
   - 回退至v1.0.13的功能版本，移除v1.0.14至v1.0.15中不必要的补丁更新
   

4. 提交代码并打标签

   git add package.json CHANGELOG.md
   git commit -m "chore: revert to v1.0.13 functionality, release v1.0.16"
   git tag v1.0.16
   git push && git push --tags
   

5. 发布新版本

   npm publish
   

额外提醒 #

• 发布前一定要反复确认本地代码完全是你想要回退的状态，避免再次发布错误版本
• 如果你的包有较多用户，建议在README或者npm发布说明里告知用户这个版本的回退情况
• 后续更新时尽量先在本地完成充分测试，减少不必要的补丁发布

内容的提问来源于stack exchange，提问作者Taylor Austin