如何为已发布的热门npm包设置别名/重命名并保留下载量？

核心限制说明 #

npm的包名是全局唯一的，无法直接将一个已发布包重命名到他人已注册的包名。只有当目标包名属于你（你是该包的所有者）时，才能进行迁移操作；若目标包名归他人所有，只能尝试联系所有者协商转让，或更换其他未被占用的包名。

迁移操作流程（目标包名属于你时） #

1. 同步代码与版本到目标包
   切换到原包的代码目录，修改package.json中的name字段为目标包名，确保版本号合理（可与原包最新版本一致，或发布更高版本），然后执行发布命令：

   npm publish
   

   若目标包已有历史版本，覆盖需谨慎，建议先备份目标包的历史版本内容。

2. 废弃原包并引导用户迁移
   将原包的所有版本标记为废弃，安装原包的用户会收到迁移提示：

   npm deprecate <原包名>@* "此包已迁移至<目标包名>，请使用新包名获取最新更新"
   

3. 实现原包的“别名”效果（可选）
   若要让继续使用原包名的用户也能获取目标包的最新内容，可以在原包的后续发布版本中：

   • 在package.json中添加目标包作为依赖
   • 在原包的入口文件（如index.js）中直接导出目标包的内容：

     module.exports = require('<目标包名>');
     

   这样用户安装原包时，实际使用的是目标包的代码。

关于历史下载量的问题 #

npm的下载统计数据是与包名强绑定的，无法将原包名的历史下载量合并到目标包名上：

• 原包名的历史下载量会保留在npm的统计页面中，但不会同步到目标包名
• 目标包名的下载量只能从发布之日起重新累积

不过你可以在目标包的README、文档中明确说明这是原包的迁移版本，并引用原包的历史下载数据，以此向用户证明项目的规模与认可度，维持信任度。

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