运行Jest测试时出现ReferenceError: cptable is not defined错误的求助

我之前也碰到过一模一样的问题，这本质是Jest的模块解析逻辑和生产环境构建工具（比如Webpack）存在差异，导致xlsx库依赖的cptable全局变量没被正确加载。下面是几个亲测有效的解决办法：

方案1：Mock整个react-export-excel模块 #

如果你的测试不需要验证Excel导出的具体业务逻辑，最简单的方式就是直接mock这个依赖，避开真实模块的加载问题。在你的测试文件顶部添加：

jest.mock('react-export-excel', () => ({
  ExcelFile: jest.fn(() => null),
  ExcelSheet: jest.fn(() => null),
  // 如果你还用到了该库的其他组件，记得在这里补充对应的mock
}));

这样Jest在测试时会用你定义的假组件替代真实模块，自然不会触发cptable未定义的错误。

方案2：配置Jest的模块映射 #

如果需要保留部分真实导出逻辑，可以通过Jest的moduleNameMapper让它正确定位cptable对应的模块。在jest.config.js（或者package.json的jest配置字段）中添加：

module.exports = {
  // 其他已有的配置项...
  moduleNameMapper: {
    'cptable': '<rootDir>/node_modules/xlsx/dist/cpexcel.js'
  }
};

这个配置会告诉Jest，当遇到对cptable的引用时，直接指向xlsx库自带的cpexcel.js文件，补全缺失的全局变量定义。

方案3：提前加载cpexcel.js #

在你的测试文件最顶部（一定要在导入CustomReport组件之前），手动导入cpexcel.js，确保cptable全局变量在xlsx库加载前就已初始化：

import 'xlsx/dist/cpexcel.js';
// 之后再导入你的业务组件
import CustomReport from '../components/CustomReport';

这种方式直接对齐了生产环境的依赖加载逻辑，让Jest能正确识别全局变量。

为什么生产环境没问题？ #

生产环境中，Webpack这类构建工具会自动遍历模块依赖树，正确加载xlsx依赖的cpexcel.js文件，初始化cptable全局变量。但Jest的模块解析是独立的，没有这个自动处理流程，所以会抛出错误。你看到的那个GitHub issue提到移除"use strict"对你的场景不适用，毕竟你根本没用到这个语句，上面的方案才是针对Jest环境的直接解法。

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