如何通过.npmrc非交互式登录GitHub npm注册表实现包自动化发布？

我想通过.yml文件实现npm包的自动化发布，尝试用.npmrc替代交互式npm login登录GitHub npm注册表，但一直失败。

成功的交互式发布流程 #

在项目根目录执行以下命令可正常发布包：

npm login
username: myName
password: xyz
npm publish

失败的.npmrc配置尝试 #

创建包含以下内容的.npmrc文件后，执行npm publish触发权限错误：

@myOrg:registry=https://npm.pkg.github.com/
//npm.pkg.github.com/:username=myName
//npm.pkg.github.com/:_authToken=xyz

错误信息：

npm ERR! code ENEEDAUTH
npm ERR! need auth This command requires you to be logged in to https://npm.pkg.github.com/
npm ERR! need auth You need to authorize this machine using `npm adduser`

补充配置信息 #

• 交互式登录和.npmrc使用的密钥xyz完全一致
• package.json已配置正确的发布信息：

{
    "name": "@myOrg/myRepo",
    "version": "0.0.1",
    "description": "...",
    "repository": {
        "type": "git",
        "url": "https://github.com/myOrg/myRepo.git"
    },
    "publishConfig": {
        "registry": "https://npm.pkg.github.com/"
    }
    ...
}

解决方法 #

1. 修正.npmrc配置格式 #

GitHub npm注册表要求必须配置邮箱字段，且确保令牌与域名的映射完全匹配，修改后的.npmrc内容如下：

@myOrg:registry=https://npm.pkg.github.com/
//npm.pkg.github.com/:username=myName
//npm.pkg.github.com/:_authToken=xyz
//npm.pkg.github.com/:email=你的GitHub绑定邮箱@example.com

2. 确认令牌权限 #

你使用的xyz必须是GitHub个人访问令牌（PAT），且需勾选以下权限：

• write:packages：允许发布包
• read:packages：允许拉取包
• 若为组织包，需确保令牌拥有该组织的对应权限

3. CI/CD中动态配置的正确方式 #

在GitHub Actions的.yml文件中，推荐用npm config set命令动态配置，避免手动创建文件的格式问题：

steps:
  - name: 拉取代码
    uses: actions/checkout@v4
  - name: 配置Node.js环境
    uses: actions/setup-node@v4
    with:
      node-version: '20'
  - name: 配置npm注册表
    run: |
      npm config set @myOrg:registry https://npm.pkg.github.com/
      npm config set //npm.pkg.github.com/:username myName
      npm config set //npm.pkg.github.com/:_authToken ${{ secrets.GITHUB_TOKEN }}
      npm config set //npm.pkg.github.com/:email 你的GitHub绑定邮箱@example.com
  - name: 发布npm包
    run: npm publish

注意：如果使用GitHub内置的GITHUB_TOKEN，需在仓库设置中开启Packages权限；也可以将自定义PAT存入仓库Secrets中调用。

4. 验证配置有效性 #

执行npm config list命令，查看当前生效的npm配置，确认@myOrg:registry和对应域名的_authToken已正确设置。

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