无法将历史NPM包推送至GitHub Packages的解决方案咨询

1. 配置GitHub Packages认证 #

先在本地全局~/.npmrc或项目目录的.npmrc中添加认证信息：

//npm.pkg.github.com/:_authToken=你的GitHub个人访问令牌
@你的组织名:registry=https://npm.pkg.github.com

注意：令牌需要具备write:packages权限，若包关联私有仓库，还需额外配置repo权限。

2. 发布TGZ包（单包/批量） #

npm原生支持直接发布本地TGZ包，无需依赖源码：

• 单包发布命令：

  npm publish /path/to/your-package@x.y.z.tgz --registry=https://npm.pkg.github.com
  

• 批量发布（Linux/macOS bash脚本）：

  # 进入TGZ包所在目录后执行
  for tgz_file in *.tgz; do
      npm publish "$tgz_file" --registry=https://npm.pkg.github.com
  done
  

• 批量发布（Windows PowerShell脚本）：

  # 进入TGZ包所在目录后执行
  Get-ChildItem -Filter *.tgz | ForEach-Object {
      npm publish $_.FullName --registry=https://npm.pkg.github.com
  }
  

3. 关键注意事项 #

• 确保TGZ包内package.json的name字段带GitHub组织Scope，格式为@你的组织名/包名，否则无法发布到对应组织的GitHub Packages。
• GitHub Packages不允许覆盖已存在的版本，若目标仓库已有相同版本包，需先通过网页端或API删除，或直接跳过该版本。
• 发布前可执行npm view /path/to/your-package.tgz验证包的版本、名称等信息是否正确。

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