create-next-app 3个月前

编程语言
453
create-next-app

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 相同的集成测试套件进行测试,确保每次发布时都能按预期工作。
image
EchoEcho官方
无论前方如何,请不要后悔与我相遇。
1377
发布数
439
关注者
2222588
累计阅读

热门教程文档

Vue
25小节
Spring Cloud
8小节
MySQL
34小节
HTML
32小节
Djiango
17小节