TS2209错误成因咨询：Monorepo中项目根目录歧义问题

这个错误本质是TypeScript在解析模块package.json的**导出映射（Export Map）**时，无法确定当前模块的项目根目录，进而无法解析"."这个入口对应的实际文件路径。以下是具体成因：

• 目录结构的歧义性
  即便模块的tsconfig配置和其他模块一致，但若该模块的目录结构存在特殊情况，会导致TS自动推断根目录失败：比如模块根目录下同时存在src目录和直接放在根目录的.ts文件，或者模块内有多个嵌套的源码目录，TS无法判断哪一个是真正的源码根。

• 导出映射的解析依赖明确根目录
  当package.json中exports字段包含"."这类根入口时，TS必须明确知道模块的根目录才能映射到对应的入口文件（比如src/index.ts或根目录的index.ts）。在Monorepo场景下，TS的自动推断逻辑容易混淆Monorepo根目录和子模块根目录，导致无法确定解析基准。

• 隐式配置差异
  表面配置一致不代表实际生效的配置完全相同：比如该模块的tsconfig可能没有正确继承顶层Monorepo的配置，或者局部依赖的TypeScript版本和其他模块有细微差异，导致根目录推断逻辑不一致。可以用tsc --showConfig命令对比该模块和正常模块的实际生效配置。

• 缓存或文件变动残留
  如果该模块近期有过目录结构调整（比如移动源码目录、删除/新增文件），但编译缓存未清理，TS可能基于旧的目录结构进行推断，引发根目录歧义。

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