推荐初学者用 cdn 引入 font awesome:在 index.html 的 中添加官方 cdn 链接,如 ,即可使用 fa-solid、fa-brands 等新类名图标。

用 CDN 引入 Font Awesome(推荐初学者)
最简单的方式是直接在 index.html 的 里加一行 CDN 链接,无需下载或构建。Font Awesome 官方提供免费的 CDN 地址,支持最新版 v6(含免费图标)。
注意:v6 默认使用 fa-solid 等新类名,和旧版 v5 的 fa fa-home 不兼容。
- 在
中插入以下代码(以 v6.5.2 为例):<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css">
- 之后就能用:
<i class="fa-solid fa-house"></i>或<i class="fa-brands fa-github"></i> - 如果页面加载慢或对第三方 CDN 有合规要求,改用本地引入(见下一条)
本地引入 Font Awesome(适合生产环境)
把 Font Awesome 文件下载到项目里,避免依赖外部 CDN,也方便离线开发或定制图标集。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 去 Font Awesome 官网下载页 下载 ZIP 包,解压后取
webfonts/和css/all.min.css - 把
all.min.css放进项目css/目录,webfonts/放在同级目录(如webfonts/fa-solid-900.woff2路径要能被 CSS 正确引用) - 在
index.html中引入:<link rel="stylesheet" href="css/all.min.css">
- 若发现图标不显示,检查浏览器控制台是否报
Failed to load resource: net::ERR_ABORTED—— 很可能是webfonts/文件夹位置不对,CSS 里默认找的是上级目录的webfonts/
只引入需要的图标(减小体积)
全量引入 all.min.css 约 400KB(gzip 后约 100KB),如果只用三五个图标,没必要加载全部。
- 用官方 Icon Kits 创建精简版:登录后选图标 → 生成嵌入代码(本质是定制 CDN 链接)
- 或用
@fortawesome/free-solid-svg-icons+@fortawesome/react-fontawesome(仅限 React 项目) - 纯静态 HTML 项目更实际的做法:用 SVG Sprite 方式手动内联关键图标(适合图标数
图标不显示?先查这三件事
常见现象不是“没写对类名”,而是底层路径、协议或权限卡住了。
- 检查浏览器开发者工具的 Network 标签页:
all.min.css是否返回 200?如果是 404,说明路径写错;如果是 0B 或 pending,可能是 CSP 策略或本地文件协议(file://)限制了字体加载 - 用
font-family: 'Font Awesome 6 Free'检查是否被其他 CSS 覆盖(比如重置样式表清掉了font-family) - v6 中
fa单独用已无效,必须搭配图形容器类,例如fa-solid、fa-regular、fa-brands—— 写成<i class="fa fa-user"></i>会完全不显示
file:// 协议的限制等多个环节。本地开发时用 Live Server 启服务,比双击打开 index.html 少一半坑。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










