Next.js返回首页
Next.js logo

Blog/Deploy

从本地开发到生产部署

梳理构建、环境变量与部署检查清单,让 Next.js 应用稳定上线。

Next.js 实践笔记6 分钟阅读

本地 npm run dev 能跑,不代表生产构建一定成功。上线前应跑一次 next build,确认类型、动态路由和静态生成都按预期工作。

使用 generateStaticParams 预生成已知 slug 的文章页,可以把博客详情变成构建期静态页,访问更快,也减少运行时查数据的开销。未知 slug 再走 404。

环境变量

只在服务端使用的密钥不要加 NEXT_PUBLIC_ 前缀。客户端能读到的变量都会进入浏览器包。Mock 阶段可以没有密钥,但一旦接上真实 CMS,就要把读写权限和环境隔离想清楚。

上线检查清单

确认 404 页可访问、文章内链能从列表点进详情、metadata 在构建产物里正确、图片域名已写入 next.config。部署到 Vercel 或其他 Node 环境后,再抽查一条真实 slug 和一条不存在的 slug。

继续阅读