You need to enable JavaScript to run this app. Create React App结合SCSS时@font-face自定义字体未生效如何排查路径问题?
优惠活动
大模型
产品
解决方案
定价
更多

Create React App结合SCSS时@font-face自定义字体未生效如何排查路径问题?

核心原因

你写的@font-face的format参数不符合W3C规范,浏览器无法识别对应字体格式,直接跳过了资源加载。
各字体格式对应的标准format取值:

  • .otf → format('opentype') (你当前错写为format('otf'))
  • .ttf → format('truetype')
  • .woff → format('woff')

修复后的_fonts.scss配置

优先加载体积最小的woff格式,补充ttf、otf fallback,同时加font-display避免字体加载期间页面空白:

@font-face {
    font-family: 'LeagueGothic';
    src: local('LeagueGothic'),
         url('../../fonts/LeagueGothic-Regular.woff') format('woff'),
         url('../../fonts/LeagueGothic-Regular.ttf') format('truetype'),
         url('../../fonts/LeagueGothic-Regular.otf') format('opentype');
    font-weight: 400;
    font-style: normal;
    font-display: swap;
}

路径校验

你当前写的相对路径../../fonts/匹配现有目录结构,CRA内置的webpack能自动识别该路径资源,所以编译不会报错。

路径计算逻辑:_fonts.scss位于src/sass/abstracts/,../../代表向上回退2层目录:第一层到sass/,第二层到src/,再拼接fonts/就对应src/fonts/目录,和你的目录结构完全匹配。

如果修改后出现404,检查两点:

  • 字体文件名大小写是否和代码中完全一致(比如是否实际后缀为大写.OTF、或文件名拼写错误)
  • 确认字体文件确实放在src/fonts目录下

兜底排查

如果修改后字体仍未生效,打开浏览器开发者工具「网络」面板,筛选Font类型资源:

  • 请求返回404:优先核对上述路径、文件名问题
  • 请求返回200但未应用:检查body中定义的font-family名称和@font-face中的定义是否完全区分大小写匹配,同时确认无其他全局样式覆盖了body的字体属性

CRA会自动打包src目录下引用的字体资源,不需要将字体手动放入public文件夹。


内容的提问来源于stack exchange,提问作者Matthew Wolman

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 11:15:01