Monorepo场景下如何锁定应用依赖的特定包版本？

1. 用pnpm的overrides强制指定版本 #

在需要保留旧版本的应用的package.json里添加pnpm.overrides配置，无需修改原有workspace:*声明，直接强制该应用使用指定的旧版本：

{
  "name": "your-app",
  "dependencies": {
    "@your-repo/your-package": "workspace:*"
  },
  "pnpm": {
    "overrides": {
      "@your-repo/your-package": "1.2.3"
    }
  }
}

如果旧版本未发布到npm，也可以直接指向Git仓库的特定标签或提交：

"pnpm": {
  "overrides": {
    "@your-repo/your-package": "github:your-username/your-repo#v1.2.3"
  }
}

等后续应用完成新版本适配，直接删除这段overrides配置即可恢复默认的workspace依赖，过渡成本极低。

2. 分支隔离+workspace版本锁定 #

如果代码用Git管理，可以为未适配的应用单独创建分支，在分支中将依赖修改为指定旧版本的workspace协议：

"dependencies": {
  "@your-repo/your-package": "workspace:1.2.3"
}

这种方式适合需要长期维护旧版本适配的场景，分支能清晰隔离版本差异，不会干扰主分支的正常迭代，待适配完成后合并分支即可。

3. pnpm补丁临时兼容 #

若破坏性变更范围较小，不想修改依赖声明，可以用pnpm的补丁功能给目标包打兼容补丁：

1. 执行pnpm patch @your-repo/your-package，会生成临时目录供你修改包代码
2. 调整代码以兼容旧应用的使用方式，再执行pnpm patch commit <临时目录路径>生成补丁文件
3. 补丁会保存在应用的.pnpm/patches目录下，提交到仓库后，其他开发者安装依赖时会自动应用补丁

这种方法适合快速临时解决问题，无需改动依赖配置，等应用适配好新版本后删除补丁即可。

通用实践总结 #

• 短期过渡首选overrides：配置简单，无需改动原有依赖结构，适配完成后的清理成本低
• 长期维护用分支隔离：能明确区分版本差异，避免主分支被旧版本代码干扰
• 小范围兼容用补丁：针对微小的破坏性变更，快速修复，减少整体适配工作量

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