React / 系统课时

创建基础页面

创建基础页面

App Router 创建页面的关键只有两件事:用目录表达 URL 层级,在对应目录放置 page.tsx。掌握这条映射后,你就能从文件位置直接判断页面地址,并快速定位“文件写了但路由访问不到”的问题。

学习目标

  • 使用 page.tsx 创建一个可访问的 App Router 页面。
  • 根据目录层级判断页面对应的 URL。
  • 识别默认导出、目录位置和开发服务器验证中的常见错误。

目录就是路由入口

在 App Router 中,app 下的文件夹表示路由段,真正让某个路由可访问的是该目录中的 page.tsx。例如 app/about/page.tsx 对应 /about,而 app/dashboard/settings/page.tsx 对应 /dashboard/settings。

App Router 目录与 URL 映射

这张映射图最重要的阅读顺序是“从 app 向下看目录,再把每个文件夹名称拼到 URL 中”。page.tsx 本身不会成为 URL 的一部分。

创建一个 about 页面

在项目的 App Router 根目录中创建 app/about/page.tsx;如果项目使用的是 src/app,就在 src/app/about/page.tsx 创建,不要另外再造一套平行目录。

tsx
export default function AboutPage() {
  return (
    <main>
      <h1>关于本站</h1>
      <p>这是由 App Router 提供的基础页面。</p>
    </main>
  );
}

预期结果:当开发服务器运行后,访问 /about,页面会显示“关于本站”标题和说明文字。这里不需要额外注册路由,也不需要手写路由表。

page.tsx 必须默认导出一个可渲染的 React 组件。这个基础页面没有状态、事件或浏览器 API,因此不需要添加 "use client";保持默认的服务端组件即可。

启动并验证路由

在项目根目录启动已有的开发脚本:

bash
npm run dev

预期输出:

text
Local: http://localhost:<PORT>

实际端口和日志格式可能不同。浏览器打开 http://localhost:<PORT>/about 后,应看到刚才的页面内容;再访问不存在的路径,例如 /missing-page,应得到未匹配路由的页面结果。

常见映射可以直接按下面的规则判断:

页面文件 URL
app/page.tsx /
app/about/page.tsx /about
app/dashboard/settings/page.tsx /dashboard/settings

页面文件为什么必须叫 page

page.tsx 是 App Router 识别页面入口的约定文件名。把组件写成 app/about/about.tsx 并不会自动生成 /about 页面;它只是一个普通模块,除非被其他文件导入。类似地,同目录中的工具函数、测试文件和普通组件也不会因为位于 app 下就自动变成路由。

如果访问结果是 404,先检查文件是否位于实际使用的 app 或 src/app 目录体系,再检查目标文件名是否为 page.tsx,最后检查它是否存在默认导出。对基础静态页面来说,这三项通常就能定位绝大多数路由创建错误。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建基础页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通