编程语言
453
Next.js 的入门最简单的方法是使用 create-next-app
。这个 CLI 工具可以帮助你快速启动一个新的 Next.js 应用,并为你配置好所有必要的设置。
你可以使用默认的 Next.js 模板来创建一个新应用,或者使用官方的 Next.js 示例来创建。
交互式创建
你可以通过运行以下命令以交互方式创建一个新项目:
npx create-next-app@latest
yarn create-next-app
pnpm create-next-app
bun create-next-app
接下来,你会被询问以下问题:
项目名称是什么? my-app是否使用 TypeScript? 否 / 是 是否使用 ESLint? 否 / 是 是否使用 Tailwind CSS? 否 / 是 是否将代码放在 `src/` 目录中? 否 / 是 是否使用 App Router?(推荐) 否 / 是 是否为 `next dev` 启用 Turbopack? 否 / 是 是否自定义导入别名(默认 `@/*`)? 否 / 是
回答完这些问题后,系统会根据你的答案创建一个配置好的新项目。
非交互式创建
你还可以通过命令行参数来设置一个非交互式的新项目。
此外,你可以通过在选项前添加 --no-
来否定默认选项(例如 --no-eslint
)。
查看 create-next-app --help
:
用法:create-next-app [项目目录] [选项] 选项: -V, --version输出版本号 --ts, --typescript 作为 TypeScript 项目初始化。(默认) --js, --javascript 作为 JavaScript 项目初始化。 --tailwind 使用 Tailwind CSS 初始化。(默认) --eslint 使用 ESLint 初始化。 --app 作为 App Router 项目初始化。 --src-dir 在 `src/` 初始化 --turbo 默认启用 Turbopack 用于开发 。 --import-alias<要配置的别名> 指定要使用的导入别名(默认 "@/*") --empty 初始化一个空项目。 --use-npm 明确指定 CLI 使用 npm 启动应用 --use-pnpm 明确指定 CLI 使用 pnpm 启动应用 --use-yarn 明确指定 CLI 使用 Yarn 启动应用 --use-bun 明确指定 CLI 使用 Bun 启动应用 -e, --example [名称]|[github-url] 使用示例来启动应用。你可以使用官方Next.js仓库的示例名称或GitHub URL。URL可以使用任意分支和或子目录 --example-path <示例路径> 在罕见的情况下,您的GitHub URL可能包含带斜杠分支名称(例如bug/fix-1)和示例路径(例如foobar)。在这种情况下,您必须单独指定示例径: --example-path foo/bar --reset-preferences 明确指定 CLI 重置任存储的偏好设置 --skip-install 明确指定CLI 跳过安装包 --yes 使用之前的偏好或默设置对于未明确指定的所有选项,且不提示 -h,--help 显示命令帮助信息
为什么使用 Create Next App?
create-next-app
可以在几秒钟内创建一个新的 Next.js 应用。它由 Next.js 的创建者官方维护,并且包括以下优点:
-
交互体验:运行
npx create-next-app@latest
(不带参数)将启动一个交互式体验,指导你设置项目。 - 零依赖:初始化项目只需一秒钟。Create Next App 无需任何依赖。
- 离线支持:Create Next App 会自动检测你是否处于离线状态,并使用本地包缓存启动项目。
-
支持示例:Create Next App 可以使用 Next.js 示例集合中的示例(例如
npx create-next-app --example api-routes
)或任何公共 GitHub 仓库来启动你的应用。 - 经过测试:该工具包是 Next.js monorepo 的一部分,并使用与 Next.js 相同的集成测试套件进行测试,确保每次发布时都能按预期工作。