必须用 font-display 控制字体加载行为,推荐 swap 值;优先 preload WOFF2 字体并设 crossorigin;用 document.fonts.load() 主动检测加载状态。
font-display 控制行为HTML5 页面中引入自定义字体(如通过 @font-face)后,浏览器默认会延迟文本渲染,直到字体加载完成或超时(通常 3 秒),导致 FOIT(Flash of Invisible Text)。这不是 bug,而是规范行为。关键解法是显式设置 font-display 值。
常用取值与效果:
font-display: swap:立即用备用字体显示,字体加载完后“换”成目标字体(最常用,兼顾可读性与品牌一致性)font-display: optional:只在字体缓存命中时使用,否则全程用备用字体(适合非关键字体,如装饰性标题字)font-display: block:保持默认行为(短阻塞期 + 长无样式期),不推荐示例:
@font-face {
font-family: "Inter";
src: url("/fonts/Inter.woff2") format("woff2");
font-display: swap;
}
@import 加载字体,改用
@import 在 CSS 中加载字体文件会触发额外的网络请求链路,且无法被预加载识别,造成加载时机不可控。真实项目中应把字体资源提前声明为高优先级。
正确做法:
中添加 ,指定 as="font" 和 type="font/woff2"
crossorigin 属性存在(即使字体同源),否则字体可能被浏览器忽略@font-face 声明,preload 只负责提前获取,不替代它示例:
WOFF2 提供平均 30%~50% 的体积压缩率,且所有现代浏览器(Chrome 36+、Firefox 39+、Safari 10+、Edge 14+)均已原生支持。继续提供 TTF、EOT 或 WOFF 1 是冗余负担,增加 HTTP 请求量和 CDN 缓存压力。
实操建议:
web-font-generator 或 fonttools 将原始字体转为 WOFF2,丢弃其他格式.woff2 文件返回 Content-Type: font/woff2
document.fonts.load() 主动检测仅靠 font-display: swap 不能解决「字体始终加载失败」的问题——比如 CDN 故障、路径错误、CORS 拦截。此时用户看到的仍是备用字体,但你无法得知是否异常,也无法做降级提示或上报。
可用 document.fonts.load() 手动探测:
new FontFace() + fontFace.load()

示例:
document.fonts.load("16px Inter").then(() => {
console.log("Inter loaded");
}).catch(err => {
console.warn("Inter failed to load", err);
document.body.classList.add("font-fallback");
});
字体加载不是“加个 link 就完事”的环节,真正棘手的是跨浏览器的加载时序差异、缓存策略与错误静默。尤其当字体用于关键按钮或表单标签时,一次加载失败就等于一次可访问性退化——这点很容易被 Lighthouse 报告忽略,但用户感知极强。