You need to enable JavaScript to run this app. CSS中@font-face配置无误但网站自定义字体无法加载的求助
优惠活动
大模型
产品
解决方案
定价
更多

CSS中@font-face配置无误但网站自定义字体无法加载的求助

@font-face 自定义字体不生效排查

从你贴出的现有CSS配置,已经能定位到几处明确的语法和配置硬伤,先修正这些问题再排查其他场景:

  • 语法错误1:@font-face块内重复声明了3次独立的src属性。按照CSS层叠规则,后面的src会完全覆盖前面的所有src值,你第一行写的ttf格式字体路径,从规则生效阶段就被后续的src覆盖,根本不会被浏览器加载。
  • 语法错误2:第二行src声明的末尾多打了逗号,导致浏览器解析语法中断,后面跟的woff2格式的src路径,完全没有被解析到有效CSS规则里。
  • 配置遗漏:你现在引入的本身是粗斜体版本的AppleGaramond字体,但@font-face里完全没有声明对应的font-weight、font-style属性。浏览器不会自动把这个字体匹配到设置了font-weight: 700的h1元素上,最终会直接回退到默认serif字体显示。

修正后的标准@font-face配置参考:

@font-face {
  font-family: 'AppleGaramond';
  /* 所有格式的字体路径写在同一个src声明内,按浏览器支持优先级从高到低排列 */
  src: url('fonts/applegaramond-bolditalic-webfont.woff2') format('woff2'),
       url('fonts/applegaramond-bolditalic-webfont.woff') format('woff'),
       url('fonts/AppleGaramond-BoldItalic.ttf') format('truetype');
  /* 补全字体对应的权重、样式声明,让浏览器能正确做匹配 */
  font-weight: 700;
  font-style: italic;
  font-display: swap;
}

改完基础配置后,还可以按以下方向排查剩余问题:

  • 核对字体文件的相对路径:你写的fonts/xxx是相对当前CSS文件所在目录的路径,不是相对网站根目录的路径。如果当前CSS文件存放在assets/css/目录下,写fonts/xxx实际请求的是assets/css/fonts/xxx,路径错位会直接导致字体404加载失败。
  • 检查服务器对字体文件的MIME类型配置:如果服务器返回的字体文件Content-Type不符合规范,浏览器会直接拦截加载,就算文件能正常访问也不会被用于页面渲染。
  • 打开浏览器开发者工具的网络面板,筛选字体类型的请求,确认每一个字体文件的请求状态:
    • 返回404:代表路径配置或者文件存放位置有误
    • 返回200但页面没加载这个字体:代表@font-face的属性(权重、样式)和页面元素的设置不匹配,浏览器没有匹配到要调用这个字体
    • 报跨域错误:代表字体文件所在域名和当前页面域名不一致,没有配置CORS跨域许可

内容的提问来源于stack exchange,提问作者Laura Nguyen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 04:06:04