使用Yarn安装GitHub Packages私有库需重复指定scope的问题求解

配置异常定位 #

你遇到的问题由三个典型配置错误叠加导致：

• 消费侧.yarnrc的scope registry地址少写一个斜杠，触发Yarn的包名解析逻辑异常
• 未配置GPR私有包的访问凭证，导致请求返回401未授权
• 可选：库端package.json的repository字段使用git协议，可能导致GPR包元数据关联异常

逐步修复方案 #

1. 修正scope registry地址 #

你当前的.yarnrc配置存在明显的拼写错误，将https:/修正为https://：

# 错误配置
"@org-name:registry" "https:/npm.pkg.github.com"

# 正确配置
"@org-name:registry" "https://npm.pkg.github.com"

如果使用Yarn 2+版本，需对应修改.yarnrc.yml配置：

npmScopes:
  org-name:
    npmRegistryServer: "https://npm.pkg.github.com"
    npmAlwaysAuth: true

2. 补充GPR访问认证 #

401错误为未授权访问导致，需配置具有read:packages权限的GitHub个人访问令牌（PAT）：
在.yarnrc中添加以下配置：

//npm.pkg.github.com/:_authToken "你的GitHub PAT值"

注意：包含PAT的配置文件不要提交到公共代码仓库，建议存放在用户根目录的全局.yarnrc中，或通过环境变量注入。

3. 可选：修正库端repository字段 #

建议将库package.json中的git协议repository地址替换为HTTPS格式，避免GPR元数据解析异常：

{
  "repository": {
    "type": "git",
    "url": "https://github.com/org-name/lib-name.git"
  }
}

修改后重新发布新版本即可。

4. 验证安装 #

清理本地缓存后执行安装命令：

yarn cache clean @org-name/lib-name
yarn add @org-name/lib-name

内容的提问来源于stack exchange，提问作者Damon J. Murray