如何在不提升版本号的前提下更新NPM平台已发布的自有包文件？

核心结论 #

公共NPM官方Registry默认禁止覆盖已发布的相同版本号的包，你无法在不升级版本号的前提下更新已发布的正式版包文件。

规则说明 #

NPM官方设置该规则的核心目的是保障全链路的依赖稳定性：如果同一个版本号对应的代码可以被随意修改，所有依赖该版本的项目都可能遇到不可预期的代码突变故障，哪怕你认为是无影响的细小修改，也有可能触发下游项目的兼容性问题。

你对官方文档的描述存在理解偏差：官方提到的「仅当你对已发布包做出重大变更时才需要升级版本」，指的是不需要为细小变更升级主版本号，而非不需要升级任何版本号。按照语义化版本规范：

• 细小bug修复、无功能影响的优化需要升级修订号（即版本号第三位，例如1.0.0→1.0.1）
• 向下兼容的新功能新增需要升级次版本号（即版本号第二位，例如1.0.1→1.1.0）
• 存在不兼容变更的重大更新才需要升级主版本号（即版本号第一位，例如1.1.0→2.0.0）

替代方案 #

如果你不想频繁升级正式版本号，可以选择以下适配方案：

• 开发阶段本地调试可以使用npm link命令将本地包链接到测试项目，不需要发布到Registry
• 需要发布测试版本供他人试用时，可以发布带标签的预发布版本，执行npm publish --tag beta命令即可，版本号可以命名为1.0.0-beta.1这类格式，不会影响正式版本的普通用户
• 如果你使用的是企业内部私有NPM Registry，可以联系管理员开启版本覆盖权限，权限开启后可执行npm publish --force命令覆盖已发布版本，该操作风险极高，严禁在公共Registry或者生产环境使用

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