配置多入口的TypeScript包引入子模块报TS2307错误如何解决？

1. 低于4.5版本的TypeScript默认使用node模块解析策略，不会读取package.json的exports字段，仅会按照传统的文件路径规则查找模块。
2. 旧版TypeScript处理子路径的typesVersions映射时，要求对应子路径在包根目录存在物理文件作为匹配入口，否则会直接忽略typesVersions的配置，你所有产物都放在dist目录下，根目录没有对应module2的入口文件，因此触发类型找不到的TS2307错误。
3. 旧版本ts-node默认不开启对exports字段的解析，运行时也会出现模块查找失败的问题。

方案1：添加根目录存根文件（最常用，无侵入） #

在你的npm包根目录下新增两个存根文件，发布时一起打包上传即可：

1. 根目录新建module2.js，用于匹配运行时的模块查找：

if (typeof module !== 'undefined' && module.exports) {
  // 兼容CJS导入
  module.exports = require('./dist/cjs/module2.js')
} else {
  // 兼容ESM导入
  export * from './dist/es/module2.js'
}

2. 根目录新建module2.d.ts，用于匹配类型查找：

export * from './dist/types/module2'

3. 确认你的package.json的files字段包含这两个文件和整个dist目录，避免发布时遗漏：

{
  "files": ["dist", "module2.js", "module2.d.ts"]
}

方案2：调整产物输出结构 #

如果你的子模块数量不多，可以直接把编译后的CJS、ESM、类型产物放到包根目录，不需要嵌套在dist文件夹内，这样传统模块解析策略就能直接找到对应文件，无需额外配置。

方案3：补充高版本TS用户的配置提示 #

对于使用TS 4.5+版本的使用者，可以提示他们在tsconfig.json中开启如下配置，即可直接读取你已经配置好的exports和typesVersions字段，无需存根文件：

{
  "compilerOptions": {
    "moduleResolution": "NodeNext",
    "module": "NodeNext"
  }
}

• 确认你发布npm包时没有通过.npmignore规则排除了dist目录，或在package.json的files字段中遗漏了dist目录，否则即使配置正确也会找不到文件。
• 如果你的子模块数量较多，可以编写简单的构建脚本自动生成所有子模块的存根文件，不需要手动逐个创建。

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