解决 create-t3-turbo 项目中本地模块无法找到的问题

在 create-t3-turbo 项目中，开发者可能会遇到一个常见问题：TypeScript 无法解析项目内部的本地模块路径，特别是 @acme/db 相关的模块。这个问题通常表现为 TypeScript 报错"找不到模块"或"找不到类型声明"，即使项目已经成功安装依赖并运行了数据库迁移。

问题现象

当开发者按照标准流程初始化项目后：

1. 通过模板创建新项目
2. 复制环境变量文件并配置数据库连接
3. 安装依赖
4. 执行数据库迁移

此时在代码编辑器中，TypeScript 会提示无法解析 @acme/db/client 和 @acme/db/schema 等模块路径。尝试运行开发服务器时，构建过程也会因同样的模块解析问题而失败。

问题根源

这个问题通常由以下几个因素共同导致：

1. TypeScript 项目引用关系未正确建立：monorepo 项目中，子包之间的依赖关系需要显式声明
2. 构建顺序问题：某些依赖包需要先构建才能被其他包使用
3. 缓存不一致：构建系统的缓存可能导致旧版本的类型定义被使用
4. 依赖版本冲突：特别是与身份验证相关的包可能存在版本兼容性问题

解决方案

完整清理和重建

最可靠的解决方法是执行完整的项目清理和重建：

# 清理工作区
pnpm clean:workspaces

# 清理pnpm存储
pnpm store prune

# 删除turbo缓存
rm -rf .turbo

# 重新安装依赖
pnpm install

# 执行完整构建
pnpm build

分步验证

如果问题仍然存在，可以尝试分步验证：

1. 首先单独构建 db 包：

   cd packages/db
   pnpm build
   

2. 然后构建依赖 db 的其他包：

   cd ../api
   pnpm build
   

3. 最后构建应用层：

   cd ../../apps/nextjs
   pnpm build
   

版本锁定

对于身份验证相关的依赖问题，可以尝试锁定特定版本：

1. 编辑 package.json 文件
2. 移除 @auth/core 和 next-auth 版本号前的 ^ 符号
3. 指定已知稳定的版本号

预防措施

为了避免类似问题再次发生，建议：

1. 在修改代码前先执行完整构建
2. 定期清理构建缓存
3. 关注依赖包的更新日志，特别是处于 beta 阶段的包
4. 考虑使用更严格的版本控制策略

通过以上方法，大多数情况下可以解决 create-t3-turbo 项目中的本地模块解析问题，使开发环境恢复正常工作状态。