React / 系统课时

加载本地与网络字体

加载本地与网络字体

这一课解决自定义字体接入后请求变多、首屏闪烁和文字尺寸变化导致布局抖动的问题。你会同时配置 next/font/google 与 next/font/local,把字体纳入 Next.js 构建流程,并用统一的 CSS 变量控制正文和品牌字体。

学习目标

  • 使用 next/font/google 加载并自托管提供商字体
  • 使用 next/font/local 接入项目内的 .woff2 字体文件
  • 通过 CSS 变量与构建验证减少字体切换带来的布局变化

理解 next/font 的加载方式

next/font 的重点不只是“能显示某种字体”。对于 Google Fonts,Next.js 会在构建阶段获取所需字体并把资源随应用一起提供,浏览器运行时不必再向 Google Fonts 发起第三方字体请求。对于本地字体,则直接从项目文件生成对应的字体声明和资源引用。

这两种来源最终都可以暴露为 CSS 变量,因此页面不必在组件中到处拼字体类名。字体配置集中后,正文、标题和组件库也更容易保持一致。

配置网络字体与本地字体

下面假设项目使用 App Router,并把品牌字体文件放在 app/fonts/BrandSans.woff2。先创建 app/fonts.ts:

ts
import { Inter } from "next/font/google";
import localFont from "next/font/local";

export const inter = Inter({
  subsets: ["latin"],
  variable: "--font-inter",
  display: "swap",
});

export const brand = localFont({
  src: "./fonts/BrandSans.woff2",
  variable: "--font-brand",
  display: "swap",
});

然后在根布局中一次性挂载字体变量:

tsx
import type { Metadata } from "next";
import { brand, inter } from "./fonts";
import "./globals.css";

export const metadata: Metadata = {
  title: "字体加载示例",
};

export default function RootLayout({
  children,
}: Readonly<{
  children: React.ReactNode;
}>) {
  return (
    <html lang="zh-CN">
      <body className={`${inter.variable} ${brand.variable}`}>{children}</body>
    </html>
  );
}

再在 app/globals.css 中定义实际使用规则:

css
:root {
  --font-sans: var(--font-inter), Arial, sans-serif;
  --font-brand-stack: var(--font-brand), var(--font-sans);
}

body {
  margin: 0;
  font-family: var(--font-sans);
}

h1,
h2 {
  font-family: var(--font-brand-stack);
}

预期结果:普通正文优先使用 Inter,一级和二级标题优先使用本地 BrandSans;若某个字体暂时不可用,浏览器会按后续回退字体继续排版,而不是让文本完全不可见。

减少布局抖动的关键

display: "swap" 允许浏览器先用回退字体显示文本,再切换到目标字体。它能避免长时间看不到文字,但如果回退字体和目标字体的字面宽度差异很大,仍可能出现轻微重排。因此真正要减少抖动,还应避免在客户端挂载后才动态决定字体,也不要在组件的 useEffect 中再切换全局字体。

把字体放进根布局并在服务端生成确定的类名,可以让首屏 HTML 一开始就带上正确字体规则。对于品牌字体,优先使用 .woff2 并只携带实际需要的字重;一个页面同时加载许多不使用的字重,会直接增加字体下载成本。

验证构建与资源

字体配置属于构建链路的一部分,修改后应至少执行一次生产构建,而不是只看开发模式页面是否“看起来正常”:

bash
npm run build

预期输出会随 Next.js 版本略有不同,关键是构建成功且没有字体下载失败或本地文件缺失错误,例如:

text
✓ Compiled successfully in <TIME>
✓ Generating static pages ...

如果提示找不到 BrandSans.woff2,先检查路径是否相对 app/fonts.ts 正确;如果只在 CI 中出现 Google 字体下载失败,则说明构建环境的网络策略需要处理,或应切换成本地托管字体。

字体体验的目标不是追求更多字体,而是让来源、字重和应用范围都可预测。把字体接入构建流程、集中到根布局并控制实际加载集合,通常比在页面里临时追加 <link> 或 CSS @import 更稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载本地与网络字体

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

登录哪都通