css自定义字体加载失败怎么办_@font-face路径与格式声明说明

10次阅读

字体加载失败主因是路径错误或格式声明不匹配:路径须相对于 CSS 文件,且 @font-face 的 src 需与文件类型及浏览器兼容性一致;推荐优先使用 woff2 并提供 fallback。

css 自定义字体加载失败怎么办_@font-face 路径与格式声明说明

字体加载失败,多数情况是路径写错或格式声明不匹配。核心就两点:路径能被 浏览器 正确访问,且 @font-face 中的 src 声明与实际文件类型、浏览器支持能力一致。

路径必须相对 CSS 文件本身,不是 HTML 页面

CSS 里的 url() 是相对于当前 CSS 文件位置解析的,不是相对于网页 HTML 所在路径。比如:

  • CSS 文件在 /assets/css/style.css
  • 字体文件在 /assets/fonts/MyFont.woff2
  • 那么 url('../fonts/MyFont.woff2') 才对(向上退一级进 fonts)
  • 写成 url('/fonts/MyFont.woff2') 就可能 404——除非你服务器真把 fonts 放在网站根目录下

优先用 woff2,但务必提供 fallback 格式

现代浏览器基本都支持 woff2,压缩率高、加载快。但旧版 Safari(woff 或 truetype (.ttf)。建议按兼容性从高到低排列:

  • url('MyFont.woff2') format('woff2') —— 主力格式
  • url('MyFont.woff') format('woff') —— 兜底给老 Safari / Android 4.x
  • url('MyFont.ttf') format('truetype') —— 最后保底(IE9+、部分旧移动浏览器)

浏览器会按顺序尝试,遇到第一个能加载的就停。别漏写 format(),否则某些浏览器无法识别类型。

立即学习 前端免费学习笔记(深入)”;

检查文件是否真能通过 URL 访问

直接把 url() 里的路径粘贴到浏览器地址栏,看能不能下载字体文件。如果返回 404 或 403:

  • 确认文件确实存在,大小不为 0
  • 检查服务器是否允许该扩展名被访问(如 Nginx 默认可能禁止 .ttf/.woff 直链,需加 MIME 类型配置)
  • 开发时用本地服务(如 Vite、Webpack Dev Server)一般没问题;但用 file:// 协议打开 HTML 会因跨域限制导致字体加载失败——必须走 http(s) 服务

字体名声明要和 font-family 调用一致

@font-face 中的 font-family 是自定义别名,后续 CSS 里用它调用。注意:

  • 别名里不要有空格或特殊符号(可用短横线,如 'My-Font'
  • 引用时大小写敏感,font-family: 'my-font';'My-Font' 不等价
  • 可加 font-weight / font-style 区分粗细或斜体版本,避免被浏览器错误合并

基本上就这些。路径对了、格式全了、文件可访问、名字写准了,字体就能稳稳加载。不复杂但容易忽略细节。

以上就是

星耀云
版权声明:本站原创文章,由 星耀云 2025-12-14发表,共计1153字。
转载说明:转载本网站任何内容,请按照转载方式正确书写本站原文地址。本站提供的一切软件、教程和内容信息仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。
text=ZqhQzanResources