如何在Monorepo中确保Zod等依赖始终使用单一实例？

问题背景 #

我的Monorepo结构如下：

packages/
    client/
        src/
        package.json
    server/
        src/
        package.json
    shared/
        src/
        package.json
package.json

我原本计划在根目录安装zod，并在所有子包中将zod声明为peerDependency，实现各子包共用根目录的依赖。但执行npm install后，发现根目录和子包的node_modules中都存在zod实例。

由于zod依赖单一实例才能保证instanceof判断正常工作（跨包创建的对象会导致判断失效），我需要解决多实例问题。此前尝试过Lerna的--hoist选项和useWorkspaces: true，但这两种方式都会移除子包的package-lock.json，还会将错误版本的依赖内容同步到根目录锁文件中，不符合需求。

可行解决方案 #

1. 统一版本 + 根目录安装 + 子包声明匹配依赖 #

• 在根目录package.json的dependencies中明确安装固定版本的zod，例如："zod": "3.22.4"
• 所有子包的package.json中，将zod声明为dependency或devDependency，并使用与根目录完全一致的版本号（或用^/~确保版本范围完全匹配）
• 执行npm install时，npm的依赖提升机制会自动将子包的zod依赖合并到根目录，避免多实例

2. 用 npm overrides 强制统一版本 #

如果子包依赖的第三方库引入了不同版本的zod，可在根目录package.json中添加overrides字段，强制所有包使用指定版本：

{
  "overrides": {
    "zod": "3.22.4"
  }
}

此配置会忽略所有子包和第三方依赖声明的zod版本，统一安装指定版本并提升到根目录，彻底杜绝多实例问题。

3. 避免在Monorepo内部使用peerDependency #

peerDependency的设计目标是让宿主应用提供依赖，而非Monorepo内部共享依赖。在Monorepo场景下，直接声明dependency并统一版本，更利于npm的依赖提升逻辑生效，减少不必要的依赖冲突。

4. 保留子包package-lock.json的方法 #

若需要保留子包的锁文件，可按以下步骤操作：

• 先在根目录执行npm install完成依赖提升和根目录锁文件生成
• 进入每个子包单独执行npm install --no-save，该命令会生成子包的package-lock.json但不会修改根目录的依赖配置

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