如何为Yarn v4配置.yarnrc.yml适配同作用域不同仓库私有npm包

针对同作用域@my-company下不同包对应GitLab不同项目私有Registry的场景，Yarn v4无法通过传统的npmScopes直接实现，需要结合npmRegistries和packageExtensions来精确配置，具体.yarnrc.yml内容如下：

nodeLinker: node-modules

# 集中定义所有私有Registry的认证信息
npmRegistries:
  "https://gitlab.com/api/api-version/projects/project-id-1/packages/npm/":
    npmAlwaysAuth: true
    npmAuthToken: ${auth-token}
  "https://gitlab.com/api/api-version/projects/project-id-2/packages/npm/":
    npmAlwaysAuth: true
    npmAuthToken: ${auth-token}
  "https://gitlab.com/api/api-version/projects/project-id-3/packages/npm/":
    npmAlwaysAuth: true
    npmAuthToken: ${auth-token}

# 为每个具体包指定对应的Registry地址
packageExtensions:
  "@my-company/package1@*":
    npmRegistryServer: "https://gitlab.com/api/api-version/projects/project-id-1/packages/npm/"
  "@my-company/package2@*":
    npmRegistryServer: "https://gitlab.com/api/api-version/projects/project-id-2/packages/npm/"
  "@my-company/package3@*":
    npmRegistryServer: "https://gitlab.com/api/api-version/projects/project-id-3/packages/npm/"

yarnPath: .yarn/releases/yarn-4.1.1.cjs

配置说明 #

• npmRegistries：统一管理所有私有Registry的认证规则，避免重复配置令牌和权限参数，确保每个源的认证信息一致。
• packageExtensions：通过包名@版本范围的格式，为单个包绑定专属Registry，*表示匹配该包的所有版本，Yarn会根据此配置定向拉取对应源的包资源。

注意事项 #

• 确保环境变量${auth-token}已正确配置GitLab个人访问令牌（需具备私有包读取权限），也可直接替换为令牌字符串（不推荐硬编码，优先使用环境变量保障安全）。
• 配置完成后，可通过yarn install安装依赖，或执行yarn info @my-company/package2验证是否能正常获取对应包的信息。

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