React / 系统课时
完成首页改造
完成首页改造
本课把默认首页改造成一个简洁的课程欢迎页。你将修改页面组件和全局样式,启动开发服务器,并通过浏览器与生产构建完成第一次功能验收。
学习目标
- 修改 App Router 的根页面组件
- 使用全局样式完成基础布局
- 从开发预览到生产构建完成验收
明确最小需求
首页只需要完成三件事:显示课程名称、说明当前进度,并提供一个指向后续内容的按钮。第一版不引入状态管理、接口请求或组件库,重点是打通最小开发闭环。
页面文件位于 app/page.tsx。根路径 / 会渲染这个文件默认导出的 React 组件。
编写首页组件
将 app/page.tsx 替换为下面的内容:
tsx
import Link from "next/link";
export default function HomePage() {
return (
<main className="home">
<p className="eyebrow">Next.js 全栈开发教程</p>
<h1>从一个可运行的首页开始</h1>
<p className="intro">
开发环境已经准备完成,接下来将学习 App Router 的页面与路由结构。
</p>
<Link className="primaryLink" href="/about">
查看下一页
</Link>
</main>
);
}这个组件不使用浏览器状态,因此保持为默认的服务端组件即可,不需要添加 "use client"。
添加页面样式
在 app/globals.css 末尾追加下面的样式。若模板已有会影响页面的默认样式,可先删除冲突规则,再保留必要的全局重置。
css
.home {
min-height: 100vh;
display: grid;
place-content: center;
gap: 16px;
max-width: 760px;
margin: 0 auto;
padding: 48px 24px;
}
.eyebrow {
font-weight: 700;
}
.intro {
line-height: 1.7;
}
.primaryLink {
width: fit-content;
padding: 10px 16px;
border: 1px solid currentColor;
border-radius: 8px;
text-decoration: none;
}这些样式只负责布局与可读性,没有依赖特定主题颜色,因此可以继续沿用模板的明暗模式设置。
开发模式验证
启动开发服务器:
bash
npm run dev预期结果:
text
浏览器访问 http://localhost:<PORT> 后,页面显示课程名称、主标题、说明文字和“查看下一页”链接。实际端口以终端输出为准。此时点击链接可能进入 404 页面,因为 /about 尚未创建;这正是下一章要解决的路由问题,不影响当前首页验收。
生产构建验收
停止开发服务器后执行:
bash
npm run build预期结果:
text
项目完成编译与类型检查,根页面被成功纳入生产构建。如果构建提示未使用导入、模块不存在或 JSX 语法错误,应根据报错文件和行号修复,再重新构建。不要只以浏览器暂时显示正常作为完成标准。
验收标准
首页改造完成后,应满足四项条件:根路径可访问;主要文案与需求一致;页面在窄屏下没有明显横向滚动;npm run build 成功结束。
这次改造刻意保持简单,因为页面结构越小,越容易区分路由、组件和样式分别承担的职责。
按自己的节奏,确认真正理解。