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 成功结束。

这次改造刻意保持简单,因为页面结构越小,越容易区分路由、组件和样式分别承担的职责。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成首页改造

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

登录哪都通