字体不显示90%因资源未加载成功,需查Network面板:404为路径错,0或failed多因file://协议限制,200但预览为空则MIME类型错误或文件损坏;@font-face中url()路径须相对CSS文件而非HTML,避免中文/空格及错误编码。

字体不显示,90% 问题出在字体资源根本没加载成功,而不是 CSS 写错了。直接看 Network 面板里的字体请求状态,比反复检查 font-family 拼写高效得多。
怎么确认字体文件是否真正被请求并返回 200
打开开发者工具 → 切换到“网络”(Network)标签页 → 在筛选框输入 fonts 或选择下拉菜单中的 Fonts → 刷新页面。重点看三类状态:
- 状态码是
404:路径错误,浏览器压根没找到文件 - 状态码是
0或显示(failed):极大概率是本地用file://协议双击打开 HTML,百度浏览器、旧版 Edge、部分 Safari 会直接禁用字体加载 - 状态码是
200但预览为空、响应长度为 0 或提示Failed to load response data:服务器没返回二进制流,或 MIME 类型错误(如返回了text/plain而不是font/woff2)
@font-face 的 src 路径为什么总 404
url() 是相对于当前 CSS 文件的位置,不是 HTML 文件。这个错位非常隐蔽,且浏览器不报错,只静默回退。
- 如果 CSS 在
css/style.css,字体在fonts/inter.woff2,就得写url('../fonts/inter.woff2') - 别写
url('/fonts/inter.woff2')—— 这是根路径,只在服务端配了/映射时才有效,本地开发基本失效 - 路径里含中文、空格或
%编码错误(如%20没解码),某些浏览器会整条@font-face忽略 - 最稳做法:把字体文件和 CSS 放同一目录,
url('inter.woff2')保持原样
为什么加了 font-display: swap 还是白屏或跳变
font-display: swap 必须写在每个 @font-face 规则内部才生效,写在外面、用 JS 设置、或只在第一个字重里写,其余都无效。
阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria
- 漏写
format('woff2'):iOS/macOS Safari 15+ 会跳过整条规则,font-display根本不执行 - 没配
crossorigin就preload字体:必须带crossorigin属性,否则 Chrome 不解析为字体资源,缓存也无法复用 - fallback 字体和 Web 字体度量差异大:比如用
sans-seriffallback,Windows 渲染 Arial、macOS 渲染 Helvetica,而你的 Inter 字体行高、字宽不同,就会明显跳动(CLS) - 字体文件本身损坏或不完整:即使状态码是 200,也建议下载该字体文件后用系统字体管理器或在线工具验证能否正常安装
CORS 报错但字体 URL 点开能访问
控制台报 Font from origin 'https://cdn.example.com' has been blocked,但你复制 URL 到新标签页能正常下载——这不是文件不存在,而是服务器没返回正确的响应头。
-
上加crossorigin属性无效,浏览器会忽略 - 真正要配的是字体文件所在服务器(CDN / OSS / Nginx)的响应头:
Access-Control-Allow-Origin: *或精确域名,且必须包含Access-Control-Allow-Methods: GET - 如果用了
,href 必须和@font-face中src的路径完全一致(包括查询参数),否则预加载不触发字体解析 - Cloudflare、阿里云 OSS 等平台需单独开启“字体类型”的 CORS 规则,不能只依赖通配符
字体加载失败几乎从不报红错,它只是安静地消失。最可靠的判断依据永远是 Network 面板里那个字体请求的状态码和响应头,而不是页面看起来像不像预期。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










