TurboRepo内部包@repo/types导入时出现TypeScript 2307模块未找到错误

我太懂这种“代码能跑但TypeScript报错”的烦躁了——明明功能正常，红色波浪线却在编辑器里晃来晃去，总让人觉得心里不踏实😅。咱们一步步来排查解决这个2307模块未找到的问题：

首先，确认基础Workspace配置是否到位 #

1. 检查根目录的package.json
   确保根目录的workspaces字段正确包含了你的packages目录（如果Web应用在apps文件夹里也一起加上）：

   {
     "workspaces": [
       "packages/*",
       "apps/*"
     ]
   }
   

   这是TurboRepo识别内部包的基础，如果这里没配置对，TS根本不知道@repo/types对应哪个文件夹。

调整TypeScript配置，让TS能定位到@repo/types #

2. 给Web包的tsconfig加上路径映射
   打开Web应用的tsconfig.json，在compilerOptions里添加baseUrl和paths，明确告诉TS@repo/*对应的实际文件路径：

   {
     "compilerOptions": {
       "baseUrl": ".",
       "paths": {
         "@repo/*": ["../packages/*"] // 假设Web应用在apps/web目录，相对路径指向packages文件夹
       },
       "moduleResolution": "bundler", // 匹配你package.json里的"type": "module"配置
       "allowImportingTsExtensions": true, // 允许直接导入.ts源码文件
       "noEmit": true // 一般Web框架（比如Next.js）会自行处理编译，不需要TS输出文件
     }
   }
   

   如果你的Repo有根目录的全局tsconfig.json，也可以把这个路径映射配置在根文件里，让所有包自动继承，这样更省心。

3. 修复Types包的tsconfig继承问题
   你之前用相对路径extends是因为直接引用@repo/typescript-config/nextjs.json报错，这大概率是@repo/typescript-config包的配置有遗漏。打开它的package.json，确保files字段包含了对应的tsconfig文件：

   {
     "name": "@repo/typescript-config",
     "private": true,
     "version": "1.0.0",
     "files": [
       "nextjs.json",
       "base.json" // 如果你有基础配置文件的话也加上
     ]
   }
   

   改完之后，回到Types包的tsconfig.json，把extends改回workspace引用：

   {
     "extends": "@repo/typescript-config/nextjs.json",
     // 其他配置保持不变
   }
   

4. 优化Types包的package.json模块导出
   因为你的package.json设置了"type": "module"，建议把exports字段调整为更规范的Node.js模块格式，帮助TS更好识别类型入口：

   "exports": {
     ".": {
       "types": "./index.ts",
       "import": "./index.ts"
     }
   }
   

最后，清理缓存重启服务 #

有时候缓存会导致配置不生效，执行以下操作：

# 重新安装依赖（根据你的包管理器选择对应命令）
pnpm install # 或 yarn install / npm install

# 清理TurboRepo缓存
pnpm turbo clean

然后重启VSCode的TypeScript语言服务：按Ctrl+Shift+P（Mac是Cmd+Shift+P），选择「TypeScript: Restart TS Server」，等服务重启后看看错误是否消失。

额外检查点 #

• 确认你的Types包的index.ts确实在packages/types/目录下，并且正确导出了InventoryItem等类型
• 检查Web包的package.json里的@repo/types依赖确实是"workspace:*"，没有拼写错误

按照这些步骤来，应该就能解决这个TypeScript的2307错误了！

备注：内容来源于stack exchange，提问作者Bharat Soni