技术文献

react-icons图标

2026-11-18

react-icons 是 React 中非常流行的图标库,可以直接把图标当作 React 组件使用,不需要自己编写 SVG,也不需要单独引入图标字体。

它整合了 Font Awesome、Bootstrap Icons、Material Design、Lucide 等多种图标库。

GitHub+1

 

1. 安装 react-icons

在项目根目录执行:

npm install react-icons

2. 引入图标

例如,使用 Font Awesome 图标:

import { FaHome, FaUser, FaSearch } from "react-icons/fa";

function App() {
  return (
    <div>
      <FaHome />
      <FaUser />
      <FaSearch />
    </div>
  );
}

这里有几个需要理解的地方:

  • react-icons:图标库的 npm 包名称。
  • fa:Font Awesome 图标集合。
  • FaHome:具体的图标组件。

注意:图标名称采用大驼峰命名法。

3. 常见图标库及导入方式

react-icons 支持很多图标集合。

图标库导入路径图标前缀
Font Awesomereact-icons/faFa
Font Awesome 6react-icons/fa6Fa
Bootstrap Iconsreact-icons/bsBs
Material Designreact-icons/mdMd
Ionicons 5react-icons/io5Io
Lucidereact-icons/luLu
Remix Iconreact-icons/riRi
Tabler Iconsreact-icons/tbTb

例如:

import { FaHome } from "react-icons/fa";
import { MdSettings } from "react-icons/md";
import { BsGithub } from "react-icons/bs";
import { LuUser } from "react-icons/lu";

function App() {
  return (
    <div>
      <FaHome />
      <MdSettings />
      <BsGithub />
      <LuUser />
    </div>
  );
}

4. 设置图标大小和颜色

图标组件支持 size、color 等属性。

import { FaHome } from "react-icons/fa";

function App() {
  return (
    <div>
      <FaHome size={16} color="red" />

      <FaHome size={24} color="blue" />

      <FaHome size={32} color="green" />
    </div>
  );
}

也可以使用 CSS:

<FaHome className="text-2xl text-blue-500" />

如果项目使用 Tailwind CSS,这种方式非常方便。

5. 图标可以绑定点击事件

因为图标本身就是 React 组件,所以可以正常使用 React 的事件处理机制。

import { FaHeart } from "react-icons/fa";

function App() {
  return (
    <FaHeart
      size={24}
      color="red"
      onClick={() => alert("点击了爱心")}
    />
  );
}

实际项目中,更推荐把图标放在 button 内部,方便键盘操作和无障碍访问:

<button onClick={() => alert("收藏成功")}>
  <FaHeart size={20} />
  收藏
</button>

6. IconContext:统一设置图标样式

如果一个页面有很多图标,每个图标都单独设置 size 和 color 比较麻烦。

可以使用 IconContext.Provider:

import { IconContext } from "react-icons";
import { FaHome, FaUser, FaCog } from "react-icons/fa";

function App() {
  return (
    <IconContext.Provider
      value={{
        color: "blue",
        size: "24px",
        className: "my-icon"
      }}
    >
      <FaHome />
      <FaUser />
      <FaCog />
    </IconContext.Provider>
  );
}

这样 Provider 内部的图标就会使用统一的默认样式。

GitHub

 

7. 到哪里查找图标?

GitHub - react-icons/react-icons: svg react icons of popular icon packs · GitHub

 

 

React Icons 官方图标库

可以按图标名称、图标集合查找

打开 React Icons 图标搜索网站

8. 一个完整的 React + TypeScript + Tailwind 示例

import { FaHome, FaUser, FaCog } from "react-icons/fa";

function Sidebar() {
  return (
    <div className="w-60 p-4 space-y-4">

      <div className="flex items-center gap-3">
        <FaHome size={20} />
        <span>首页</span>
      </div>

      <div className="flex items-center gap-3">
        <FaUser size={20} />
        <span>用户</span>
      </div>

      <div className="flex items-center gap-3">
        <FaCog size={20} />
        <span>设置</span>
      </div>

    </div>
  );
}

export default Sidebar;

特别注意一个概念:

<FaHome /> 看起来像 HTML 标签,但它实际上是一个 React 组件。

这和你之前学习的自定义组件 <MyComponent /> 是一样的原理,只不过 FaHome 是 react-icons 库提供的组件。

官方文档:React Icons GitHub。