React 18 + AG Grid 31.0.3 企业模块无法正常使用求助

1. 全局导入企业版核心文件 #

AG Grid 31.x版本里，企业特性不需要手动逐个注册模块，直接在项目入口文件（比如index.js/main.tsx）里全局导入ag-grid-enterprise即可自动注册所有企业模块：

import 'ag-grid-enterprise';

把这行代码放在AgGridReact组件导入之前，避免初始化顺序问题。

2. 避免Tree Shaking误删企业版代码 #

如果项目开启了Tree Shaking（比如Vite、Create React App生产模式），可能会把ag-grid-enterprise的代码当成无用代码摇掉。在package.json里添加sideEffects配置：

{
  "sideEffects": [
    "ag-grid-enterprise/**/*"
  ]
}

3. 彻底清理依赖与缓存 #

• 删除node_modules文件夹和锁文件（package-lock.json/yarn.lock）
• 重新执行npm install或yarn install
• 清理构建工具缓存：
  • Create React App：执行npm run clean
  • Vite：删除.vite目录
  • Webpack：删除dist及缓存目录

4. 检查依赖版本一致性 #

执行命令验证三个依赖的安装版本是否完全一致：

npm list ag-grid-community ag-grid-enterprise ag-grid-react

如果出现子版本不匹配，用npm dedupe扁平化依赖树，或者手动锁定版本号。

5. 移除组件层面的modules配置 #

如果之前给AgGridReact组件传了modules属性，直接删掉——全局导入企业版后已经自动注册所有模块，手动传入反而可能导致冲突。

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