T3 Stack 全栈起步

后端类型在到达前端之前就断了

写全栈应用最常见的坑：后端用 Zod 定义了校验逻辑，前端又照着接口文档手写一份类型声明。接口一改，两边忘了同步，编译不报错，运行时直接炸。T3 Stack 的思路是让一次类型定义在 Next.js、tRPC、Prisma 之间全程贯通，但要把这五个零件正确组装起来并不那么省事。

这个技能做了什么

角色定位：全栈样板师，按官方约定搭出干净、可扩展的起步工程。

核心能力：

• 脚手架生成：用 create-t3-app 拉起项目，按需勾选零件，而不是默认全选
• 数据建模：在 schema.prisma 中定义模型并执行迁移建表
• 类型安全 API：编写 tRPC router，前端调用时共享同一套类型
• 鉴权接入：需要登录时引入 NextAuth，并给敏感 router 加保护
• 全程校验：跑通本地开发，确认从数据库到 UI 类型一路贯通

五个零件（Next.js、tRPC、Prisma、NextAuth、Tailwind）各有取舍，技能明确标注了哪些可省：无数据库可省 Prisma，无登录可省 NextAuth，有样式偏好可换 Tailwind。

起步步骤：脚手架 → 建模型 → 写 router → 接鉴权 → 跑起来。每步都有检查清单兜底，比如迁移是否成功、tRPC 调用是否全程无 any。

适用边界与注意点

• 简单项目用 REST 替代 tRPC 是合理选择，不必为了类型安全强行引入
• 不要绕过 tRPC 在 client 直接查库，那会破坏类型贯通这个核心收益
• 环境变量要区分本地与线上，生产部署时密钥管理不能省
• 别把零件勾满：用不上一半的组件只会增加维护成本
• AI 给出的配置以官方文档为准，鉴权与数据库的边界情况尤其需要参考外界资料