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 向下看目录,再把每个文件夹名称拼到 URL 中”。page.tsx 本身不会成为 URL 的一部分。
创建一个 about 页面
在项目的 App Router 根目录中创建 app/about/page.tsx;如果项目使用的是 src/app,就在 src/app/about/page.tsx 创建,不要另外再造一套平行目录。
export default function AboutPage() {
return (
<main>
<h1>关于本站</h1>
<p>这是由 App Router 提供的基础页面。</p>
</main>
);
}预期结果:当开发服务器运行后,访问 /about,页面会显示“关于本站”标题和说明文字。这里不需要额外注册路由,也不需要手写路由表。
page.tsx 必须默认导出一个可渲染的 React 组件。这个基础页面没有状态、事件或浏览器 API,因此不需要添加 "use client";保持默认的服务端组件即可。
启动并验证路由
在项目根目录启动已有的开发脚本:
npm run dev预期输出:
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,最后检查它是否存在默认导出。对基础静态页面来说,这三项通常就能定位绝大多数路由创建错误。