已配置React为peerDependencies，npm link的Notistack为何出现重复React报错

1. peerDependencies的作用边界 #

peerDependencies本质是版本合规校验规则，仅在包被正式安装到宿主项目时生效：npm会检查宿主是否安装了符合版本范围的对等依赖，不符合则抛出警告。它不会干预Node.js默认的模块路径查找逻辑，也不会自动让依赖包复用宿主的对应依赖实例。

2. npm link场景下的模块查找逻辑 #

Node.js遵循就近查找的模块解析规则：当你通过npm link把本地fork的Notistack关联到项目时，Notistack的代码运行在它自己的本地仓库目录下，执行require('react')时会优先查找自身目录下的node_modules。
从你提供的package.json可以看到，react同时被列在了devDependencies里，也就是说你本地fork的Notistack目录的node_modules里已经安装了一份独立的React，所以会直接使用这份，而不会继续向上遍历到宿主项目的node_modules查找，自然就出现了两个React实例。

3. 手动npm link生效的原因 #

你在Notistack目录下执行npm link react，本质是把Notistack自身node_modules里的React替换成了宿主项目目录下React的软链接，此时两者引用的是同一份React实例，冲突自然消失。 #

如果不想每次都手动link，可以用以下方法规避：

• 开发阶段临时删除Notistack本地node_modules里的react、react-dom等对等依赖，找不到本地依赖时会自动向上查找宿主项目的对应依赖
• 如果你用webpack/vite作为构建工具，可以配置依赖别名强制所有React引用指向项目内的版本，以webpack为例：

  // webpack.config.js
  module.exports = {
    resolve: {
      alias: {
        'react': path.resolve(__dirname, './node_modules/react'),
        'react-dom': path.resolve(__dirname, './node_modules/react-dom')
      }
    }
  }
  

• 使用pnpm的pnpm.overrides或者yarn的resolutions字段全局锁定React版本

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