UI5(TypeScript)项目中Cannot find module 'xlsx'问题解决咨询

下面是针对你遇到的模块找不到问题的具体解决步骤：

• 调整TypeScript配置
  报错提示明确要求设置moduleResolution为node，打开项目根目录的tsconfig.json，确保编译器配置包含以下项：

  {
    "compilerOptions": {
      "moduleResolution": "node",
      "module": "ESNext",
      "allowSyntheticDefaultImports": true
    }
  }
  

  保存配置后，重启TypeScript语言服务（比如重启VS Code）让设置生效。

• 修复类型依赖版本不匹配
  你当前安装的@types/xlsx版本（^0.0.36）和xlsx本体版本（^0.18.5）差距过大，旧类型定义无法适配新版xlsx。而且新版xlsx已经内置了TypeScript类型，无需单独安装@types/xlsx，直接卸载旧类型包即可：

  npm uninstall @types/xlsx --save-dev
  

  之后重新安装xlsx确保依赖状态正常：

  npm install xlsx --save-dev
  

• 适配UI5模块加载机制
  UI5默认使用AMD模块系统，而xlsx属于CommonJS/ES模块，需要配置UI5工具链识别外部包。在项目根目录的ui5.yaml中添加如下配置：

  builder:
    resources:
      excludes:
        - "/node_modules/**"
    customTasks:
      - name: ui5-task-zipper
        afterTask: generateCachebusterInfo
        configuration:
          archiveName: "webapp.zip"
          additionalFiles:
            - "node_modules/xlsx/dist/xlsx.full.min.js"
  

  如果ES导入仍有问题，可改用全局声明的方式使用xlsx：

  // 控制器顶部添加声明
  declare var XLSX: any;
  // 使用示例
  const sheet = XLSX.utils.json_to_sheet(yourData);
  

  也可以直接在index.html中引入xlsx脚本：

  <script src="node_modules/xlsx/dist/xlsx.full.min.js"></script>
  

• 清理依赖缓存
  若以上步骤无效，尝试清理依赖缓存并重新安装：

  rm -rf node_modules package-lock.json
  npm install
  

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