introduction

最容易使用Next.js 的方式就是通过create-next-app,这个CLI 工具能够让你快速启动构建一个新的Next.js 应用,配置了默认的一切 .. 能够使用默认的Next.js 模板创建新的app,或者使用存在的任何官方Next.js 示例的其中之一,为了开始,使用以下命令:

  1. npx create-next-app@latest
  2. # or
  3. yarn create next-app

或者使用TypeScript project 通过 --ts, --typescript标志

  1. npx create-next-app@latest --ts
  2. # or
  3. yarn create next-app --typescript

Options

create-next-app包含了如下选项:

  • --ts,--typescript 初始化为一个ts 项目
  • -e,--example [name] [github-url] 引导App的一个示例,你能够使用来自Next.js 仓库 或者一个Github URL(这个URL 可以是一个分支或者子目录) ..
  • --example-path [path-to-example]真实情况下,你的Github URL 可能包含了使用了斜杠的分支名 .(bug/fix-1) 以及示例的路径(例如,foo/bar),这种情况下,必须单独指定示例的路径:

--example-path foo/bar

  • --use-npm显式的告诉CLI 使用npm 引导App,为了使用yarn 引导App,通过yarn create next-app

为什么使用Create Next App

  • create-next-app允许你在以秒为单位的情况下创建一个新的Next.js,它通常是由Next.js的创建者所维护,包含了许多好处 ..
    • 可交互体验,通过运行npx create-next-app@latest(无任何参数) 启动一个交互体验的指南让你配置一个项目)
  • 零依赖 通常在一秒内即可初始化项目,Create Next App 具备零依赖
  • 离线支持 Create Next App 将自动的检测如果你是离线并引导你的项目(使用本地包缓存)
  • 示例支持 可以通过Next.js 的示例集合中作为模板引导项目(npx create-next-app --example api-routes)
  • Tested 这个包是Next.js monorepo的一部分并且使用由Next.js 自己使用的相同集成测试套件进行测试,确保它会如期工作 ..