create-next-app

create-next-app CLI 允许你使用默认模板或来自公共 GitHub 仓库的示例创建新的 Next.js 应用。这是开始使用 Next.js 的最简单方式。

基本用法：

Terminal

npx create-next-app@latest [project-name] [options]

参考

以下选项可用：

选项	描述
`-h` 或 `--help`	显示所有可用选项
`-v` 或 `--version`	输出版本号
`--no-*`	否定默认选项。例如 `--no-eslint`
`--ts` 或 `--typescript`	初始化为 TypeScript 项目（默认）
`--js` 或 `--javascript`	初始化为 JavaScript 项目
`--tailwind`	初始化时包含 Tailwind CSS 配置（默认）
`--eslint`	初始化时包含 ESLint 配置
`--app`	初始化为 App Router 项目
`--api`	初始化仅包含路由处理程序的项目
`--src-dir`	在 `src/` 目录中初始化
`--turbopack`	默认为开发环境启用 Turbopack
`--import-alias <alias-to-configure>`	指定要使用的导入别名（默认为 "@/*"）
`--empty`	初始化一个空项目
`--use-npm`	明确告诉 CLI 使用 npm 引导应用程序
`--use-pnpm`	明确告诉 CLI 使用 pnpm 引导应用程序
`--use-yarn`	明确告诉 CLI 使用 Yarn 引导应用程序
`--use-bun`	明确告诉 CLI 使用 Bun 引导应用程序
`-e` 或 `--example [name] [github-url]`	用于引导应用程序的示例
`--example-path <path-to-example>`	单独指定示例的路径
`--reset-preferences`	明确告诉 CLI 重置任何已存储的偏好
`--skip-install`	明确告诉 CLI 跳过安装软件包
`--yes`	对所有选项使用之前的偏好或默认值

示例

使用默认模板

要使用默认模板创建新应用，请在终端中运行以下命令：

Terminal

npx create-next-app@latest

然后你将被询问以下提示：

Terminal

What is your project named?  my-app
Would you like to use TypeScript?  No / Yes
Would you like to use ESLint?  No / Yes
Would you like to use Tailwind CSS?  No / Yes
Would you like your code inside a `src/` directory?  No / Yes
Would you like to use App Router? (recommended)  No / Yes
Would you like to use Turbopack for `next dev`?  No / Yes
Would you like to customize the import alias (`@/*` by default)?  No / Yes

一旦你回答了提示，将会使用你选择的配置创建一个新项目。

使用官方 Next.js 示例

要使用官方 Next.js 示例创建新应用，请使用 --example 标志。例如：

Terminal

npx create-next-app@latest --example [example-name] [your-project-name]

你可以在 Next.js 仓库中查看所有可用示例的列表以及设置说明。

使用任何公共 GitHub 示例

要使用任何公共 GitHub 示例创建新应用，请将 --example 选项与 GitHub 仓库的 URL 一起使用。例如：

Terminal

npx create-next-app@latest --example "https://github.com/.../" [your-project-name]