Next.js 本地开发指南
使用 Next.js 构建 React 全栈应用,App Router 支持 SSR/SSG,本地默认 localhost:3000。
Next.js 是基于 React 的全栈框架,提供 App Router、服务端组件、API 路由、静态导出与边缘部署。广泛用于生产级 Web 应用与营销站点。
快速开始
npx create-next-app@latest my-app
cd my-app
npm run dev默认 localhost 访问
| 用途 | 地址 |
|---|---|
| 开发服务器 | http://localhost:3000 |
修改端口:npm run dev -- -p 3001 或在 package.json 中调整。
常用命令
| 命令 | 说明 |
|---|---|
npm run dev | 开发模式(Turbopack 可选) |
npm run build | 生产构建 |
npm run start | 运行生产服务器 |
npm run lint | ESLint 检查 |
路由与渲染
- App Router(
app/目录):推荐新项目使用 - 支持 SSR、SSG、ISR 与客户端组件混用
- API 与 Server Actions 可在同仓库内实现后端逻辑
部署
可部署到 Vercel(官方平台)、Node 服务器、Docker,或通过 output: 'export' 生成纯静态站点。
小结
Next.js 本地开发默认 **http://localhost:3000**,适合 React 全栈与 SEO 友好的现代 Web 应用。