0

0

解决 Font Awesome 图标不显示的常见原因与正确引入方法

聖光之護

聖光之護

发布时间:2026-01-28 20:26:04

|

148人浏览过

|

来源于php中文网

原创

解决 font awesome 图标不显示的常见原因与正确引入方法 - php中文网

Font Awesome 图标未显示,通常因 CSS 文件版本不匹配、缺少字体声明或 CDN 链接错误导致;本文详解如何通过引入含完整 `@font-face` 规则的官方 CDN 链接来快速修复。

在您提供的 HTML 代码中,图标(如 <i class="fa-solid fa-user-plus fa-beat"></i>)无法正常渲染,根本原因在于当前引入的 Font Awesome 样式表:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6.4.2/css/fontawesome.min.css" class="css">

该链接指向的是 fontawesome.min.css —— 它仅包含通用工具类(如 fa-solid, fa-beat)的 CSS 规则,但不包含 @font-face 声明和字体文件路径定义。这意味着浏览器虽识别了类名,却无法加载对应的 SVG 或 Web 字体资源,最终图标留空或显示为方块。

✅ 正确做法是改用 Font Awesome 官方推荐的 all.min.css 全量样式表,它内置完整的字体声明、图标映射及所有风格(solid, brands, regular)支持:

VALL-E
VALL-E

VALL-E是一种用于文本到语音生成 (TTS) 的语言建模方法

下载
<!-- ✅ 替换原 link 标签为以下内容 -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.3.0/css/all.min.css" integrity="sha512-iL4QYVn4v7Tfzq9jF+GZKkDy8wUcWdN8XxOeE6t8H2BbM2JgRZaI9Ss7PmQ=="
      crossorigin="anonymous" referrerpolicy="no-referrer">
? 小贴士:all.min.css 包含 @font-face 规则(定义字体源)、CSS 类(如 .fa-solid)、伪元素内容(::before 插入 Unicode 字符),三者缺一不可。而 fontawesome.min.css 仅为“框架”,需配合 fa-solid.css 等子模块使用——这对新手极易出错。

此外,请注意以下关键兼容性事项:

  • ❌ 避免混用多个 Bootstrap 版本:您的代码同时加载了 Bootstrap 5(@popperjs/core, bootstrap.bundle.min.js)和 Bootstrap 3.3.5(bootstrap.min.css/js),会导致样式冲突、JS 行为异常(如 data-bs-toggle 在 BS3 中无效);
  • ✅ 统一使用 Bootstrap 5:移除 twitter-bootstrap/3.3.5 的 CSS/JS 引入,保留 bootstrap@5.3.x 及其依赖(Popper);
  • ✅ 确保图标语法匹配所选版本:Font Awesome 6 使用 fa-solid fa-user-plus(非旧版 fa fa-user-plus),且 fa-beat 是 FA6.2+ 新增动画类,需对应版本 ≥6.2.0。

最后验证步骤:

  1. 打开浏览器开发者工具(F12)→ Network 标签 → 检查 all.min.css 是否 200 加载成功;
  2. Elements 面板中右键图标 <i> → “Inspect” → 查看是否应用了 ::before 伪元素及正确 content 值;
  3. Console 中无 Failed to load resource: fontawesome-webfonts... 类型报错。

遵循以上方案,即可彻底解决图标空白问题,让 fa-solid、fa-brands、动画类等全部正常渲染。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2023.12.20

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

931

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

32

2025.12.06

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

532

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6357

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

494

2023.09.01

c++ 字符处理
c++ 字符处理

本专题整合了c++字符处理教程、字符串处理函数相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.03.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.0万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.7万人学习

CSS教程
CSS教程

共754课时 | 44.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号