解决create-t3-turbo项目中Expo无法导入其他工作区包的问题

在create-t3-turbo项目中，开发者可能会遇到一个常见问题：无法将其他工作区(workspace)的包成功导入到Expo应用中。这个问题表现为在构建Expo应用时，Metro打包器无法解析来自其他工作区的依赖包，即使这些包已经正确安装在node_modules目录中。

问题现象

当尝试从其他工作区(如@acme/validators)导入模块到Expo应用时，会出现类似以下的错误：

Android Bundling failed 4976ms
Unable to resolve "@acme/validators" from "src\app\index.tsx"

问题原因

这个问题的根源在于Metro打包器对工作区包的处理方式。虽然pnpm工作区已经正确设置了依赖关系，但Metro在解析模块路径时没有正确处理package.json中的exports字段配置。

解决方案

方法一：添加main字段

对于单入口点的包，最简单的解决方案是在包的package.json中添加main字段，明确指定入口文件路径：

{
  "main": "src/index.ts"
}

这种方法适用于大多数简单场景，能够确保Metro正确找到包的入口文件。

方法二：配置exports字段

对于更复杂的多入口点包，需要正确配置exports字段。这是Node.js官方推荐的模块解析方式：

{
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "default": "./src/index.ts"
    }
  }
}

然而，需要注意的是，当前Metro打包器对exports条件的支持可能还不够完善，这可能会导致一些额外的配置问题。

实施步骤

1. 在需要导入的包的package.json中添加main字段或正确配置exports字段
2. 在Expo应用的package.json中添加对工作区包的依赖：

   {
     "dependencies": {
       "@acme/validators": "workspace:^0.1.0"
     }
   }
   

3. 每次修改后运行pnpm install以确保依赖关系正确更新

注意事项

• 对于TypeScript项目，确保同时配置types字段以支持类型检查
• 如果使用多入口点配置，可能需要额外关注Metro打包器的兼容性问题
• 在修改配置后，建议清理构建缓存以避免缓存导致的问题

总结

在create-t3-turbo这样的monorepo项目中，工作区包之间的依赖管理需要特别注意。通过正确配置package.json中的模块解析字段，可以解决Expo应用无法导入其他工作区包的问题。对于简单项目，添加main字段是最直接的解决方案；而对于更复杂的模块结构，则需要更细致的exports配置。

随着Metro打包器对Node.js模块解析标准的支持不断完善，未来这类问题可能会得到更优雅的解决。目前开发者可以通过上述方法有效解决工作区包导入问题，确保项目正常构建和运行。