常见问题

找到您需要的答案

这里收集了开发者最常遇到的问题和解答,帮助您快速上手和解决开发中的疑问

点击问题查看详细解答

常见问题

如何快速开始使用这个脚手架?

热门

首先克隆项目到本地,然后运行 npm install 安装依赖,配置环境变量,最后运行 npm run dev 即可启动开发服务器。详细步骤请参考 README 文档。

需要配置哪些环境变量?

主要需要配置数据库连接字符串、NextAuth 密钥、JWT 密钥等。请参考 .env.example 文件中的示例配置。

支持哪些数据库?

支持 PostgreSQL、MySQL、SQLite 等主流数据库。通过 Prisma ORM 可以轻松切换不同的数据库。

如何自定义认证方式?

热门

脚手架集成了 NextAuth.js,支持多种认证提供商。您可以在 auth.js 文件中配置 Google、GitHub、邮箱登录等方式。

如何添加新的 API 路由?

在 app/api 目录下创建新的路由文件,使用 route.js 命名。脚手架提供了 proxyToBackend 工具函数简化后端 API 调用。

如何自定义 UI 组件?

脚手架使用 shadcn/ui 组件库,您可以通过 components.json 配置主题,或在 components/ui 目录下自定义组件。

如何实现国际化?

脚手架集成了 next-intl,支持多语言。在 messages 目录下添加语言文件,使用 useTranslations hook 获取翻译文本。

如何优化生产环境性能?

热门

脚手架已配置了代码分割、图片优化、缓存策略等。建议使用 Next.js 的静态生成功能,并配置 CDN 加速。

如何处理错误和日志?

建议集成 Sentry 等错误监控服务,配置日志记录。脚手架提供了基础的错误处理机制,可根据需要扩展。

如何扩展后端功能?

后端使用 Fastify 框架,支持插件系统。您可以在 server/plugins 目录下添加新插件,或在 server/routes 下添加新路由。

如何部署到生产环境?

热门

支持 Docker 部署、Vercel、Railway 等平台。脚手架提供了 Dockerfile 和 docker-compose.yml 文件,可以快速部署。

如何配置 CI/CD?

脚手架提供了 GitHub Actions 示例配置,支持自动化测试、构建和部署。您可以根据需要修改 .github/workflows 下的配置文件。

还有其他问题?

我们的技术团队随时为您提供帮助