入门
简介
nextjs是Facebook为React创建的类似webpack的开发创建,不仅如此,nextjs同时也是SSR方案。功能非常强大。
安装
我们建议使用 create-next-app 启动一个新的 Next.js 应用,它会自动为你设置所有内容。 要创建项目,请运行:
npx create-next-app@latest
安装时,你将看到以下提示:
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 to use `src/` directory? No / Yes
Would you like to use App Router? (recommended) No / Yes
Would you like to customize the default import alias (@/*)? No / Yes
What import alias would you like configured? @/*
出现提示后,create-next-app
将以你的项目名称创建一个文件夹并安装所需的依赖。
很高兴知道:
- Next.js 现在默认附带 TypeScript、ESLint 和 Tailwind CSS 配置。
- 你可以选择在项目的根目录中使用 src 目录 将应用的代码与配置文件分开。
手动安装
要手动创建新的 Next.js 应用,请安装所需的包:
npm install next@latest react@latest react-dom@latest
打开 package.json
文件并添加以下 scripts
:
{
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start",
"lint": "next lint"
}
}
这些脚本涉及开发应用的不同阶段:
dev
: 运行 next dev 以在开发模式下启动 Next.js。build
: 运行 next build 来构建用于生产的应用。start
: 运行 next start 来启动 Next.js 生产服务器。lint
: 运行 next lint 来设置 Next.js 的内置 ESLint 配置。
创建目录
Next.js 使用文件系统路由,这意味着应用中的路由由你构建文件的方式决定。
app
目录
对于新应用,我们建议使用 应用路由。 该路由允许你使用 React 的最新功能,并且是基于社区反馈的 页面路由 的演变。
创建 app/
文件夹,然后添加 layout.tsx
和 page.tsx
文件。 当用户访问应用的根目录 (/
) 时,将渲染这些内容。
使用所需的 <html>
和 <body>
标签在 app/layout.tsx
内创建 根布局:
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}
最后,创建一个主页 app/page.tsx
,其中包含一些初始内容:
export default function Page() {
return <h1>Hello, Next.js!</h1>
}
export default function Page() {
return <h1>Hello, Next.js!</h1>
}
很高兴知道: 如果你忘记创建
layout.tsx
,Next.js 将在使用next dev
运行开发服务器时自动创建此文件。
了解有关 使用应用路由 的更多信息。
pages
目录(可选)
如果你更喜欢使用页面路由而不是应用路由,你可以在项目的根目录下创建一个 pages/
目录。
然后,在 pages
文件夹中添加 index.tsx
文件。 这将是你的主页 (/
):
export default function Page() {
return <h1>Hello, Next.js!</h1>
}
接下来,在 pages/
内添加 _app.tsx
文件来定义全局布局。 了解有关 自定义应用文件 的更多信息。
import type { AppProps } from 'next/app'
export default function App({ Component, pageProps }: AppProps) {
return <Component {...pageProps} />
}
export default function App({ Component, pageProps }) {
return <Component {...pageProps} />
}
最后,在 pages/
内添加一个 _document.tsx
文件来控制服务器的初始响应。 了解有关 自定义文档文件 的更多信息。
import { Html, Head, Main, NextScript } from 'next/document'
export default function Document() {
return (
<Html>
<Head />
<body>
<Main />
<NextScript />
</body>
</Html>
)
}
了解有关 使用页面路由 的更多信息。
很高兴知道: 尽管你可以在同一项目中使用两个路由,但
app
中的路由将优先于pages
中的路由。 我们建议在你的新项目中仅使用一台路由以避免混淆。
public
文件夹(可选)
创建 public
文件夹来存储静态资源,例如图片、字体等。然后,你的代码可以从基本 URL (/
) 开始引用 public
目录中的文件。
运行开发服务器
- 运行
npm run dev
以启动开发服务器。 - 访问
http://localhost:3000
查看你的应用。 - 编辑
app/page.tsx
(或pages/index.tsx
)文件并保存以在浏览器中查看更新的结果。