跳到主要内容

create-next-app CLI

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 路由项目 | | --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 跳过安装包 | | --disable-git | 明确告诉 CLI 禁用 git 初始化 | | --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 示例创建新应用程序,请使用带有 GitHub 仓库 URL 的 --example 选项。例如:

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