如何在Jest中处理单入口导出JS库的peer依赖问题？

方案1：Jest 模块模拟（最优） #

直接在 Jest 配置里模拟缺失的 react-xyz 依赖，从根源上避免找不到模块的报错，完全不影响组件库的生产代码和 Webpack 的 tree-shaking 逻辑。

1. 在客户端项目根目录创建 __mocks__/react-xyz.js 文件，内容如下：

// 模拟空导出，也可根据测试需求模拟具体组件/方法
module.exports = {};

2. 修改 jest.config.js（或 jest.config.ts），添加模块映射规则：

module.exports = {
  // 其他配置项...
  moduleNameMapper: {
    '^react-xyz$': '<rootDir>/__mocks__/react-xyz.js'
  }
};

优势：

• 零侵入组件库代码，无需调整导出结构或依赖声明
• 完全适配现有导入方式，客户端无需修改业务代码
• 不影响生产环境的 tree-shaking 和依赖逻辑

方案2：组件内部可选导入（组件库层面优化） #

如果希望从组件库本身解决容错问题，可以给 ComponentC 的依赖添加捕获逻辑，避免 Jest 加载时直接抛出模块未找到的错误。

修改 ComponentC.js 的导入逻辑：

let ReactXyz;
try {
  ReactXyz = require('react-xyz'); // 若用 ES 模块可改为动态 import()
} catch (err) {
  // 仅在实际使用组件时抛出提示，而非加载阶段报错
  ReactXyz = null;
}

export default function ComponentC(props) {
  if (!ReactXyz) {
    throw new Error('ComponentC requires peer dependency "react-xyz" to be installed.');
  }
  // 组件正常渲染逻辑...
}

优势：

• 组件库自身具备容错性，适配任何测试框架
• 符合 peer 依赖设计初衷：仅在实际使用组件时触发依赖安装提示

方案3：拆分导出入口（备选，规避子路径冲突） #

若不想使用 Node.js 子路径导出，可以给 ComponentC 单独设置导出入口，同时保留原统一入口：

1. 在组件库根目录创建 component-c.js 文件，单独导出 ComponentC：

export { default as ComponentC } from './src/ComponentC';

2. 修改原 index.js，移除 ComponentC 的统一导出，让需要使用 ComponentC 的客户端单独导入：

export { ComponentA, ComponentB } from './src/components';
// 移除 ComponentC 导出，用户需通过 import { ComponentC } from 'foo-bar-ui/component-c' 引入

注意：该方案需要客户端调整导入路径，适合对导入灵活性要求较高的场景，但会增加使用成本。

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