macOS下因packageManager字段新增导致Node与Yarn依赖校验和错误

问题背景 #

项目环境：

• Node v20.15.0
• Yarn v4.2.2
• 已启用Corepack

项目依赖包含两个Git包：

"dependencies": {
  "first-package": "git+ssh://git@git.example.com:group/first-package.git#v2.4.0",
  "second-package": "git+ssh://git@git.example.com:group/second-package.git#v3.0.1"
}

在macOS执行yarn install时出现校验和不匹配错误：

➤ YN0018: │ first-package@git+ssh://git@git.example.com:group/first-package.git#commit=commit-hash: The remote archive doesn't match the expected checksum
➤ YN0018: │ second-package@git+ssh://git@git.example.com:group/second-package.git#commit=commit-hash: The remote archive doesn't match the expected checksum

Linux和Windows环境无此问题，排查发现macOS上Yarn会自动给Git依赖的package.json新增packageManager字段，导致校验和不一致。尝试过dependenciesMeta的built: false配置无效，查阅Yarn Issue #2399、#4917未找到解决方案。

解决方案 #

方法1：临时禁用Corepack自动注入packageManager字段 #

安装时通过环境变量临时关闭Corepack的自动pinning功能：

COREPACK_ENABLE_AUTO_PINNING=0 yarn install

如果需要全局生效，可将环境变量添加到shell配置文件（如~/.zshrc或~/.bashrc）：

export COREPACK_ENABLE_AUTO_PINNING=0

添加后执行source ~/.zshrc（对应使用的shell）使配置立即生效。

方法2：通过Yarn配置全局禁用自动注入 #

在项目根目录的.yarnrc.yml文件中添加以下配置：

corepackEnableAutoPinning: false

该配置会阻止Corepack自动给Git依赖的package.json添加packageManager字段。

方法3：针对单个Git依赖禁用自动修改 #

如果不想全局禁用，可在项目的package.json中给目标依赖添加installConfig配置：

"dependenciesMeta": {
  "first-package": {
    "installConfig": {
      "corepackAutoPin": false
    }
  },
  "second-package": {
    "installConfig": {
      "corepackAutoPin": false
    }
  }
}

方法4：修改Git依赖仓库（若有权限） #

如果可以修改依赖的Git仓库，直接在依赖的package.json中手动添加packageManager字段（值与本地项目一致即可），Yarn会跳过自动添加操作，避免校验和变化。

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