先查all.min.css是否200加载、类名是否匹配v6规范(如fas fa-house)、link标签是否置于head顶部;本地字体404需确保css中url路径相对于css文件位置,且woff2请求状态码为200。

CDN引入Font Awesome后图标不显示,先查这三件事
90% 的问题不是代码写错,而是加载链断在某个环节。CDN 方式看似简单,但依赖网络、路径、类名三者严丝合缝。
-
all.min.css是否成功加载?打开 DevTools → Network → 过滤css,确认状态码是200,不是404或blocked - 类名是否匹配 v6 规范?
fa-home已失效,必须写成fas fa-house(fas表示 solid 风格,fa-house是新图标名) -
<link>标签是否在使用图标的 HTML 元素之前?把它放在最顶部,别被其他 CSS 或 JS 挡住
本地引入 iconfont.css 时字体文件 404 怎么修
根本原因:CSS 文件里的 url('iconfont.woff2') 是相对于 CSS 文件自身位置的,不是相对于 HTML 页面。很多人把 iconfont.css 放在 /css/,却把字体丢在 /fonts/,浏览器自然去请求 /css/iconfont.woff2。
- 最稳做法:把
iconfont.woff2、iconfont.woff和iconfont.css放在同一目录,比如/static/fonts/iconfont/,CSS 里保持原样url('iconfont.woff2') - 必须分开时:打开
iconfont.css,全局替换所有url('iconfont.为url('../fonts/iconfont/iconfont.(注意路径是相对于 CSS 文件) - 绝对路径
url('/fonts/iconfont.woff2')在本地开发服务器(如 Vite 的localhost:3000/myapp/)下大概率失效,别用
为什么 <i class="iconfont icon-home"></i> 显示方块
这不是图标没加载,而是字符映射断裂。浏览器靠 .icon-home::before { content: "\e600"; } 插入私有区 Unicode,再靠 @font-face 加载的字体把 \e600 渲染成图形。任一环节出错,就只剩方块。
- 打开
iconfont.css,搜索icon-home,确认它真有定义,且content值是非空 Unicode(如"\e600"),不是空字符串或注释掉 - DevTools → Network → 过滤
font,看iconfont.woff2请求是否返回200;若 404,说明路径错;若 200 但图标仍不显,可能是 MIME 类型错误(服务器没配font/woff2) - 检查 computed 样式,确认元素实际应用的
font-family是'iconfont';如果父级写了font-family: sans-serif且没 fallback,字符会被降级显示
@font-face 加载本地字体时 fallback 失效的常见坑
自定义字体不是“声明了就能用”,浏览器会按 src 列表顺序尝试加载,一旦某个格式失败,就会跳到下一个——但如果所有格式都因路径或 MIME 错误而静默失败,最终就回退到系统字体,你可能根本察觉不到。
-
src必须至少提供woff2和woff两个格式,只放.ttf或.otf在现代浏览器中大概率不触发渲染 -
font-weight和font-style必须与字体文件元数据一致;下载的 Inter 字体若标称weight: 600,但 CSS 写成font-weight: bold,可能 fallback 到默认粗细 -
font-display: swap不是可选项;没加它,弱网下文字会长时间空白(FOIT),用户根本看不到内容
@font-face 是否被包裹在 @media 或条件规则里,或者 CSS 文件本身加载失败,导致整段规则被忽略。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











