npmstart.
开工台
开始一个项目

从 Next.js
开始一个项目。

页面路由、服务端渲染和 React,放进同一个项目。

什么时候选它?

适合需要文件路由、服务端渲染或 React 服务端能力的产品。create-next-app 会打开官方初始化向导,部分选项仍由你在终端中回答;这里显式选择 TypeScript 和包管理器。

先准备开发环境

使用满足当前 Next.js 要求的 Node.js 版本。初始化时按项目需要回答 App Router、样式工具等问题。

在新的项目父目录中打开终端,逐条运行命令。初始化向导出现问题时,以终端中的实际提示为准。

创建、安装、运行

下面使用 npm。其他包管理器可以在首页生成器切换;Yarn 命令以支持 dlx 的现代版本为前提。

终端命令
npx create-next-app@latest my-app --ts --use-npm
cd my-app
npm run dev

跑起来之后,先改哪里?

进入向导生成的项目目录,启动开发服务器,再按实际目录结构编辑 app/page.tsx 或 src/app/page.tsx。初始化工具默认会安装依赖。

什么时候考虑其他方案?

如果只需要浏览器端应用,并且已有独立的后端服务,React + Vite 是更精简的起点。

看看另一个起点

命令之外,也把需求写清楚。

选择一个场景,把第一版范围与验收标准一起准备好。

生成项目开工包

官方资料

Next.js 入门文档