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
相关产品推荐
相关产品推荐

