TypeScript导入外部包JS文件提示module not found错误如何解决

• 检查tsconfig.json全量配置
  除了allowJs: true之外，还要确认以下配置项：
  • include数组包含目标JS文件所在的目录，且exclude数组没有屏蔽对应目录
  • 确认导入路径的大小写和实际文件系统的目录、文件名完全一致，类Unix系统对路径大小写敏感，拼写不一致会触发找不到模块报错
  • 若moduleResolution配置为node16/nodenext/bundler，相对路径导入必须补全文件后缀，将导入语句修改为const abc = require('../../folder/JSFile.js')即可
  • 若使用ts-node直接运行项目，需要额外在tsconfig中添加"ts-node": {"allowJs": true}配置，默认ts-node会忽略非源文件目录的JS文件
• 检查多包/Monorepo场景的特殊配置
  若目标JS文件位于其他子包中：
  • 确认依赖包已经完成构建，未构建的源码文件不会被包管理器识别
  • 若使用了路径别名（如@xxx开头的导入路径），需要同时在tsconfig的paths配置，以及打包工具的resolve配置中对齐别名规则
• 检查模块系统适配
  若你的TS项目配置为ES模块模式（package.json中type: module，或tsconfig的module设为ESNext等），建议将CommonJS风格的require改为ES导入语法：import abc from '../../folder/JSFile.js'，同时开启esModuleInterop: true和allowSyntheticDefaultImports: true避免导出适配问题
• 验证JS文件导出完整性
  你贴出的JS代码当前仅定义了内部函数getJSFunction，没有将其作为返回值对外暴露，需要补全导出逻辑：

  module.exports = xyz => {
    const getJSFunction = async (
      param1,
      param2,
      param3,
      options = {}
    ) => {---方法体---};
    // 新增返回逻辑
    return { getJSFunction }
  }
  

• 打包工具额外配置校验
  若通过webpack/vite/rollup等打包工具运行项目，需要确认打包工具的resolve.extensions配置中包含.js后缀，且未设置过滤规则屏蔽对应JS文件的加载

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