常见问题

这里整理了一些经常被问到的问题，并给出简短回答。

开始使用需要准备什么？

你需要 Git、Node.js 18+ 和 pnpm。克隆仓库后，将 .env.example 复制为 .env，运行 pnpm install，再执行 pnpm dev。应用会启动在 http://localhost:3000。详情可查看 Quick Start 指南。

可以部署到 Cloudflare 免费计划吗？

可以。编译后的模板约 2.3 MB，低于 Workers 免费套餐的 3 MB 限制。更多信息可查看 Deployment 文档。

如何部署到生产环境？

在 wrangler.jsonc 中设置项目名称、自定义域名，以及 D1/R2 bindings。通过 pnpm wrangler secret bulk .env.production 推送密钥，然后运行 pnpm run deploy。如果连接了 GitHub 仓库，Cloudflare 也可以在 push 后自动部署。完整说明见 Deployment 指南。

支付不用 Stripe 吗？

可以。当前项目已经内置支持 Stripe、Creem 和 Waffo，可通过支付 provider 配置切换。支付模块基于 provider interface 构建；如果需要接入其他支付服务，实现 PaymentProvider 并注册对应 provider，就可以扩展新的支付提供商。邮件、newsletter 和 notification 模块也遵循同样的模式。详情见 Payment 文档。

TanStarter 同时支持订阅和一次性付款吗？

两者都支持。月付/年付订阅、终身一次性付款和免费试用都可以使用。用户可通过 Stripe Customer Portal 管理账单。如果在 Stripe 设置中启用，微信支付和支付宝也可用。更多内容见 Stripe Payment 文档。

如何添加博客文章？

在 content/blog/ 下创建 Markdown 文件，并在 frontmatter 中填写 title、description、date、category 和 image。文章会自动显示在博客页面。详情见 Blog 文档。

支持 i18n 吗？

支持。TanStarter 现在已集成基于 Paraglide 的多语言系统，默认包含英文和中文。页面文案来自 project.inlang/messages/，内容文章通过 .zh.md 这类 locale 后缀提供本地化版本。

如何同步模板更新？

将模板仓库添加为 Git remote（git remote add upstream ...），fetch 后再 merge。解决冲突后，运行 pnpm install，应用新增 migrations，并进行测试。详情见 Updates 指南。

支持哪些分析服务？

支持 Google Analytics、Umami、Plausible 和 Microsoft Clarity。可以任意组合使用。设置对应环境变量后，它们会在生产环境自动启用。详情见 Analytics 文档。

TanStarter 可以用于生产环境吗？

可以。认证、支付、管理工具、SEO、分析、邮件和存储都已内置并经过验证。已经有用户用它发布真实产品，可以在 Showcase 查看案例。查看 Quick Start 即可开始。