常见问题解答
常见初学者问题的简短回答
通用问题
什么是 Better‑T‑Stack？
一个具有明确技术选型的 CLI 工具，用于搭建完整的 TypeScript 全栈项目（前端、后端、API、数据库/ORM、认证、附加组件），采用简洁的 monorepo 结构。详见文档首页的快速开始指南。
我需要全局安装什么吗？
不需要。直接使用您的包管理器运行 CLI。请参阅快速开始指南和 CLI 部分下的各命令页面。
可以使用哪些包管理器？
npm、pnpm 或 bun（全部支持）。
需要什么 Node.js 版本？
Node.js 20+（推荐使用 LTS 版本）。
可以在现有项目中使用吗？
CLI 用于创建新项目。您可以逐步迁移或使用 add 命令来扩展 Better‑T‑Stack 项目。
生成的文件存放在哪里？
请参阅项目结构了解高层级布局（基于服务器 vs Convex，可选 web/原生应用）。
选择选项
CLI 会推荐技术栈吗？
不会。选择适合您需求的选项。CLI 会验证兼容性。请参阅 CLI（各命令）和兼容性部分了解规则。
不确定该选择 tRPC 还是 oRPC / Drizzle 还是 Prisma
请参阅兼容性部分获取指导和限制说明。这两组选项都运行良好；根据团队和托管需求进行选择。
常见问题
我的移动应用无法连接到后端（Expo）
在 apps/native/.env 中设置 EXPO_PUBLIC_SERVER_URL 为您机器的 IP 地址（不是 localhost），检查防火墙，或尝试 npx expo start --tunnel。
如何禁用遥测功能？
设置 BTS_TELEMETRY_DISABLED=1（shell 环境变量）。对于单次运行，在命令前添加；要永久禁用，请在 shell 配置文件中导出该变量。
获取帮助
- 文档：快速开始、CLI、项目结构、兼容性
- 提问/报告：GitHub Issues & Discussions
- 社区：Discord