如何在pnpm工作区中重建来自Git仓库的依赖包？

我维护着一个依赖pnpm workspaces的大型monorepo，使用的PNPM版本为7.5.0。我的部分包依赖某开源项目，但该项目存在兼容性问题，因此我fork了项目并完成缺失部分的补丁修复（已向原仓库提交PR）。

原本采用标准方式添加依赖：

pnpm add @pnp/spfx-react-control

现在替换为Git依赖：

pnpm add "github:stevebeauge/sp-dev-fx-controls-react#features/upgrade-to-spfx-1.15"

但该包的构建产物（/lib目录）未包含在源码中，导致模块缺失问题。我尝试了以下方法均未成功：

• 执行pnpm rebuild @pnp/spfx-react-control无任何反应，推测pnpm将其解析为工作区内的包
• 执行pnpm rebuild "github:stevebeauge/sp-dev-fx-controls-react#features/upgrade-to-spfx-1.15"报错：

  pnpm: Invalid argument - github:stevebeauge/sp-dev-fx-controls-react#features/upgrade-to-spfx-1.15. Rebuild can only select by version or range

• 从工作区根目录执行pnpm rebuild .\node_modules\@pnp\spfx-controls-react报错：

  pnpm: Invalid argument - .\node_modules@pnp\spfx-controls-react. Rebuild can only select by version or range

• 进入.node_modules\@pnp\spfx-controls-react\目录执行pnpm run build，因缺少依赖失败

针对pnpm 7.5.0下Git依赖的构建问题，可尝试以下几种可行方案：

方案1：通过fork仓库的prepare脚本自动构建 #

pnpm在安装Git依赖时会自动执行包内的prepare脚本。修改你fork仓库的package.json，添加或修改prepare脚本指向项目的构建命令：

{
  "scripts": {
    "prepare": "npm run build" // 替换为项目实际的构建命令，比如tsc、webpack等
  }
}

修改完成后提交到你的fork分支，然后在monorepo根目录重新安装依赖：

pnpm install

此时pnpm会拉取Git依赖并自动执行构建，生成所需的/lib目录。

方案2：手动安装依赖并构建 #

若无法修改fork仓库的配置，可手动进入依赖目录完成构建：

1. 在monorepo根目录执行pnpm install，确保Git依赖已拉取到node_modules
2. 进入目标包目录：

   cd .\node_modules\@pnp\spfx-controls-react\
   

3. 使用npm安装该包的依赖（避免pnpm workspace的依赖解析干扰）：

   npm install
   

4. 执行构建命令：

   npm run build
   

构建完成后，monorepo内的其他包即可正常引用该包的/lib目录模块。

方案3：使用--ignore-workspace参数触发重建 #

pnpm 7.x支持--ignore-workspace参数，强制将目标包视为外部依赖而非工作区内包，执行以下命令尝试重建：

pnpm rebuild @pnp/spfx-controls-react --ignore-workspace

该参数会跳过pnpm的工作区解析逻辑，直接处理这个Git依赖，触发重建流程。

方案4：通过.npmrc配置强制执行构建脚本 #

在monorepo根目录的.npmrc文件中添加以下配置，确保pnpm安装Git依赖时自动执行构建相关脚本：

auto-install-peers=true
prepare-script=true

prepare-script=true会强制pnpm执行Git依赖的prepare脚本，即使包内未显式声明，前提是fork仓库的构建命令能正常运行。

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