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:
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",
});然后在根布局中一次性挂载字体变量:
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 中定义实际使用规则:
: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 并只携带实际需要的字重;一个页面同时加载许多不使用的字重,会直接增加字体下载成本。
验证构建与资源
字体配置属于构建链路的一部分,修改后应至少执行一次生产构建,而不是只看开发模式页面是否“看起来正常”:
npm run build预期输出会随 Next.js 版本略有不同,关键是构建成功且没有字体下载失败或本地文件缺失错误,例如:
✓ Compiled successfully in <TIME>
✓ Generating static pages ...如果提示找不到 BrandSans.woff2,先检查路径是否相对 app/fonts.ts 正确;如果只在 CI 中出现 Google 字体下载失败,则说明构建环境的网络策略需要处理,或应切换成本地托管字体。
字体体验的目标不是追求更多字体,而是让来源、字重和应用范围都可预测。把字体接入构建流程、集中到根布局并控制实际加载集合,通常比在页面里临时追加 <link> 或 CSS @import 更稳定。