React / 系统课时

创建 Next.js 项目

创建 Next.js 项目

本课使用官方脚手架创建一个可直接运行的 Next.js 项目,并明确选择 TypeScript、App Router、ESLint 和路径别名。完成后,你会得到统一目录与依赖配置,而不是手工拼装工程。

学习目标

  • 使用 create-next-app 创建项目
  • 理解关键脚手架选项的作用
  • 验证项目目录与依赖安装结果

选择项目位置

先进入专门存放代码的目录,确保目标文件夹名称没有空格和特殊字符。下面以 nextjs-demo 为项目名:

bash
npx create-next-app@latest nextjs-demo

预期结果:

text
终端进入交互式问答,依次提示选择 TypeScript、代码检查、App Router 等项目选项。

脚手架会下载当前稳定模板并询问若干选项。网络较慢时命令可能停留在依赖下载阶段,但不应反复中断并重启。

推荐选项

面对交互式问题时,可按下面的方向选择:

  • TypeScript:启用,获得类型检查与编辑器提示。
  • ESLint:启用,提前发现常见代码问题。
  • Tailwind CSS:本章不是重点,可按个人需要选择。
  • src/ 目录:初学阶段可不启用,保持路径简洁。
  • App Router:启用,本教程所有路由示例都基于它。
  • 路径别名:保留默认的 @/*,减少深层相对路径。

也可以使用参数直接创建统一配置的项目:

bash
npx create-next-app@latest nextjs-demo --ts --eslint --app --use-npm --import-alias "@/*"

预期结果:

text
项目依赖安装完成,终端提示可以进入 nextjs-demo 并运行开发命令。

脚手架输出会随版本变化,但不应出现安装失败或无法解析依赖的错误。

检查生成结果

进入项目并列出顶层文件:

bash
cd nextjs-demo
ls

Windows PowerShell 可将最后一条命令替换为 Get-ChildItem。预期结果:

text
app
node_modules
public
package.json
package-lock.json
tsconfig.json
next.config.ts

实际文件可能因模板选项略有差异,例如启用 src/ 后会出现 src/app,配置文件扩展名也可能不同。关键是存在应用目录、依赖清单、TypeScript 配置和 Next.js 配置。

脚手架做了什么

脚手架创建了页面入口、根布局和基础样式,安装了 next、react、react-dom 等依赖,并在 package.json 中写入开发、构建和生产启动脚本。

它还根据选择生成 TypeScript 和 ESLint 配置。后续新增页面时,不需要再次运行脚手架,只需在现有项目中增加目录和文件。

失败时如何处理

如果提示项目目录已存在且非空,换一个项目名,或确认旧目录可以删除后再重新创建。不要直接把新模板覆盖到已有业务代码中。

如果依赖下载失败,先保留终端中的原始错误,检查网络和 npm 配置。删除半成品目录后重新执行通常比在不完整的 node_modules 上继续修补更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Next.js 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通