Iconify:30 万图标一个 API 调完,真·开源免费商用

壹贰线报 · 官方文档与首页核实 核实时点:2026 年 11 月 本期关键词:Iconify / Iconify免费 / 图标库 / SVG图标 / Iconify自托管


一句话结论

Iconify 不是一个图标库,它是一个「图标搜索引擎+分发框架」——把 Material Icons、Font Awesome、Lucide、Heroicons、Tabler、Bootstrap Icons、Feather、Carbon、Remix Icon、Ant Design Icons、Emoji(Twemoji/Noto/OpenMoji)等 200+ 套、超过 30 万个开源矢量图标 统一成一套 <Icon icon="mdi:home" /> 语法,React/Vue/Svelte/Angular/SolidJS/Web Components/CSS 一条命令全打通;核心框架 MIT 协议、完全免费可商用、无付费墙、无账号墙、无 API 调用次数强限制,甚至可以把整个 API Docker 自托管到内网。

但——"完全免费"只针对 Iconify 框架本身;每个图标集的协议是独立的,混用图标前必须挨个看一眼 License。这是本期最大的认知误区。


三处关键更正(与你给的信息对照)

❌ 更正 1:不是"20 万",是 30 万+

  • 你给的口径:"超过 20 万个开源图标"

  • 官方首页 hero 区明文(2026 年 11 月核实):"Over 300,000 open source vector icons."

  • 第三方评测/中文站常见"10 万/20 万/25 万"都是老数据——2026 年最新版本已收录 200+ 套图标集、30 万+ 图标,且每个月还在加新包(比如 Lucide/Tabler 每月都在新增图标)。

❌ 更正 2:Iconify 自己免费≠所有图标都能随便商用

  • 你给的口径容易被读成"Iconify 上所有图标都免费商用"

  • 官方首页 License 区原文:"Almost all parts of the project use MIT license… This license does not apply to icons. Icon sets use various open source licenses, see each icon set for details."

  • 翻译:框架主体 MIT(免费商用),但每个图标集协议独立:

    • ✅ MIT/CC0/Apache 2.0:随便商用(Lucide、Tabler、Heroicons、Feather、Material Symbols、Bootstrap Icons、Remix Icon、Radix Icons、Phosphor 等主流集都是这一档)

    • ⚠️ CC BY 4.0/CC BY-SA:需署名原作者+来源(比如 Font Awesome Free 的部分旧包、部分社区贡献集)

    • ⚠️ CC BY-NC/非商用:不能商用(极个别社区图标集、部分 emoji 衍生集)

    • ⚠️ Font Awesome Pro/Material Symbols Outlined 收费变体/Streamline 付费包:在 Iconify 里能看到≠能用,商用必须买授权(官方 Docs 首页置顶横幅正是 Streamline Access 付费推广)

  • 一句话:用之前点开图标详情页看 License,不要默认"能搜到就能商用"。

❌ 更正 3:不是"动态图标 API",而是"按需加载 SVG 渲染引擎+可自托管"

  • 你给的"用于动态图标的 API"表述容易误解成"提供动画图标"——官方定位是 icon components that render icons on demand(按需从 Iconify API 拉取 SVG 并渲染),不是 Lottie/GSAP 那种动效库;

  • 真正"动态"的部分是运行时按 icon 名从 CDN 拉对应 SVG、自动缓存,配合 @iconify/vite-plugin 可以在 build 时把用到的图标打包进本地,完全不需要运行时请求公网;

  • 公共 API(api.iconify.design)无明确免费调用次数硬性上限(官方文档只写"do not abuse",未给出 QPS/月配额数字),但生产环境强烈建议自托管 API(官方 iconify/api Docker 镜像一条命令搞定)。

  • Iconify 没有官方 Pro/Business 付费套餐——它是纯开源社区项目,靠 GitHub Sponsors 赞助维持(首页 Sponsor 链接指向作者 Vjacheslav Trushkin 的赞助页),不存在"免费版→付费版"的升级墙。


真·免费能力清单(Iconify 开源免费版)

能力

是否免费

说明

200+ 套图标集 / 30万+ 图标浏览/搜索

✅ 永久免费

icon-sets.iconify.design 全量开放浏览

SVG/PNG 单图标下载

✅ 永久免费

颜色/尺寸/翻转/旋转可在线调

React/Vue 2/Vue 3/Svelte/Angular/SolidJS 组件

✅ 永久免费

@iconify/react、@iconify/vue、@iconify/svelte、@iconify/angular、@iconify/solid 全部 MIT

原生 JS(SVG framework)

✅ 永久免费

@iconify/iconify,一行 <span class="iconify" data-icon="mdi:home">

Web Components / Lit

✅ 永久免费

iconify-icon 包

CSS 图标方案(零 JS)

✅ 永久免费

@iconify-icons 系列+Iconify Utils 生成 CSS

Offline/Bundler 构建插件

✅ 永久免费

@iconify/vite-plugin、unplugin-icons(社区,背后也是 Iconify 数据)

公共 API(api.iconify.design)

✅ 免费无配额(请别滥用)

国内可能偶发不稳定,建议生产自托管

自托管 API(Docker)

✅ 永久免费

iconify/api 镜像,支持 Redis 缓存

Figma/Sketch/Adobe XD 插件

✅ 免费

设计师与开发者用同一套图标名

VS Code 插件(Iconify IntelliSense)

✅ 免费

写代码实时预览图标

Iconify Tools(CLI/构建工具)

✅ MIT 开源

自定义图标集、批量转换、清理优化 SVG

API 动态渲染(按需加载 SVG)

✅ 免费

核心能力

MCP Server(AI 编程工具集成)

✅ 免费开源

2025 年已出,支持 Cursor/Claude Code 直接按自然语言选图标

商业使用

✅ 框架完全可商用

注意每个图标集各自的 License

品牌 Logo 图标集

⚠️ 谨慎商用

mdi、simple-icons 里含大量商标,商用需遵守品牌方指南


付费/边界说明

Iconify 本身没有付费版——官方首页+文档没有 Pricing 页面,全项目 GitHub Sponsors 赞助维持。需要注意的只有三类隐性"付费点":

项目

费用

说明

公共 CDN/API 高速 SLA

无 SLA

公共 API 无官方 QPS 承诺,大流量站建议自托管(Docker 部署零费用)

Streamline Access(付费图标包)

Streamline 订阅

Docs 首页顶部推广的"Expand Your Icon Collection with Streamline Access 180,000+ icons" 是第三方付费图标集,与 Iconify 核心无关

Font Awesome Pro/其他付费集内嵌图标

需各自授权

在 Iconify 里能搜索到付费集图标名称,不代表免费用

商用商标 Logo 合规

法务成本

simple-icons/logos 等包包含大量注册商标,用于产品 logo/宣传需遵守品牌商标规范


6 个必知的能力亮点

1. 一个语法通吃 200+ 图标集

mdi:home(Material Design Icons)、lucide:home(Lucide)、fa-solid:house(Font Awesome)、tabler:home(Tabler)、heroicons-outline:home(Heroicons)——同一套 <Icon icon="xxx" /> 组件,换个前缀就是换图标集,不用为每套图标单独 npm install。

2. 按需加载,不打包整个图标库

默认运行时按需拉 SVG(自动 localStorage 缓存),一个页面用 10 个图标只发 10 个请求;Vite/Webpack 插件可以在构建时把用到的图标打进 bundle,完全离线可用,最终产物体积仅增加用到的那几 KB。

3. 统一属性:尺寸/颜色/旋转/翻转全一致

所有图标接受 width/height/color/rotate/flip/hFlip/vFlip 等统一属性,跨图标集表现一致——不用再记每个库自己的 size/class 命名。

4. Offline 与自托管

内网/涉密/离线项目一条 docker run -d -p 3000:3000 iconify/api 就能把整个 API 跑起来,前端把 API host 指向私有地址,完全不依赖公网。

5. Figma ↔ 代码 名称一一对应

设计师在 Figma 里用 Iconify 插件拖的 mdi:home,开发者在代码里写 <Icon icon="mdi:home" />,名字完全一致,彻底告别"设计稿是这个图标、代码里找不到"的问题。

6. MCP Server,让 AI 直接帮你选图标

2025 年官方推出 iconify-mcp,Cursor、Claude Code、Windsurf 等 AI 编辑器可以直接通过 MCP 搜索/预览/插入图标,描述"一个带加号的用户图标"就能拿到候选。


三个最容易踩的坑

坑 1:以为"搜到=免费商用",结果踩了 CC BY-NC 或付费图标

简单粗暴判断:Lucide/Tabler/Heroicons/Feather/Material Symbols/Bootstrap Icons/Remix/Radix/Phosphor 默认放心商用;Font Awesome Free 大部分 MIT 但品牌图标有使用规范;simple-icons/logos 里全是注册商标;任何图标点进去看一眼 License 栏再用。

坑 2:生产直接用公共 API,被限流或抽风时图标全变方块

公共 API api.iconify.design 在国内访问偶发慢/抽风,而且官方明确"no abuse"。正式上线请二选一:

  • 用 @iconify/vite-plugin/unplugin-icons 在构建时把图标打包进静态资源(最稳,零运行时依赖);

  • 或 Docker 自托管 Iconify API,前端改 host 指向自己的服务。

坑 3:混用太多图标集,风格不统一

30 万图标是优势也是陷阱——一个页面混用 Material(填充)+ Lucide(线条 2px)+ Tabler(线条 1.5px)+ Font Awesome(复古),视觉上立刻变"缝合怪"。建议项目早期选定 1 套主图标集+1 套 emoji/特殊图标做补充,不要贪多。


谁特别适合 / 谁不适合

✅ 特别适合

  • 前端开发者做管理后台/官网/App,想要"一个库管所有图标",不想 npm install 十几个图标包;

  • 设计+开发协作团队,想让 Figma 里的图标名和代码里的图标名一一对应;

  • 中后台/数据密集型项目,需要大量功能图标;

  • 多技术栈团队(React+Vue+小程序并存),希望图标语法跨框架统一;

  • 内网/涉密项目,可 Docker 自托管完全离线;

  • 个人独立开发者/开源作者,零成本拿 30 万图标+MIT 商用。

❌ 不适合

  • 追求强品牌/原创插画图标:Iconify 全是通用开源图标,没有原创商业插画;

  • 纯设计小白不会写代码:直接 Canva/Iconfont 更简单,Iconify 的强项在开发集成;

  • 需要 Lottie/动效图标:Iconify 只做 SVG 静态图标,动画得自己加 CSS/GSAP;

  • 对商标合规极度敏感的上市/金融/医疗项目:simple-icons/logos 等包中商标图标需法务逐一审核,不如自己画。


4 步上手(5 分钟)

Step 1:选图标

打开 https://icon-sets.iconify.design/,搜索关键词(比如"home""user""check"),点进某个图标集挑选,复制图标名(例如 lucide:check-circle)。

Step 2:装包(以 React + Vite 为例)

# React
npm install --save-dev @iconify/react @iconify/json
# 或配 Vite 插件做离线打包(推荐生产用)
npm install --save-dev @iconify/react @iconify/vite-plugin

Step 3:vite.config.ts 配置离线打包(推荐)

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import Iconify from '@iconify/vite-plugin'

export default defineConfig({
  plugins: [
    react(),
    Iconify({ /* 会自动扫描源码里用到的图标并打包 */ })
  ]
})

Step 4:在组件里用

import { Icon } from '@iconify/react'

export default function Demo() {
  return (
    <button className="btn-primary">
      <Icon icon="lucide:check-circle" width={20} height={20} />
      提交成功
    </button>
  )
}

自托管 API(可选,内网/大流量场景)

# 一条命令启动本地 Iconify API
docker run -d --name iconify-api -p 3000:3000 iconify/api

# 前端配置 host(React 为例)
import { addAPIProvider } from '@iconify/react'
addAPIProvider('', { resources: ['http://localhost:3000'] })


免费图标方案横向对比(2026-11 版)

工具

图标数量

协议

框架支持

国内访问

离线/自托管

商用

适合场景

Iconify

30万+/200+集

MIT(框架)+图标集各自协议

React/Vue/Svelte/Angular/Solid/Web Components/CSS

公共API偶发慢,可自托管

✅ Docker自托管+离线打包

✅ 框架MIT,图标按集看协议

跨框架团队+开发集成+一套管所有

Iconfont(阿里)

百万级(用户上传)

⚠️ 不保证商用授权

字体/SVG

✅ 国内快

❌ 无官方自托管

⚠️ 需自查版权

国内设计师/简单页面

Lucide

1700+

ISC(类MIT)

React/Vue/Svelte/Vanilla

✅ CDN 可用

✅ npm包离线

✅ 完全商用

Feather 精神续作/极简线条

Tabler Icons

5900+

MIT

React/Vue/Svelte/Vue3/Angular/Solid

✅

✅

✅

中后台仪表盘/2px描边

Heroicons

300+

MIT

React/Vue

✅

✅

✅

Tailwind 生态项目

Font Awesome Free

2000+

CC BY 4.0(部分MIT)

全框架

✅

✅

⚠️ 需署名

老牌经典

Material Symbols

1万+

Apache 2.0

全框架

⚠️ Google 字体国内慢

✅

✅

Material Design 项目

Remix Icon

3000+

Apache 2.0

React/Vue/Vue3/Svelte

✅

✅

✅

国产高质量图标


你项目里的图标是怎么选的?是固定用一套(Lucide/Tabler/Material Symbols/Font Awesome),还是像 Iconify 这样多集混用?踩过"图标名字对不上设计稿""商用被警告"的坑吗?

下期想看哪款工具的免费额度核实?留言点单,我来拆官方文档。

—— 壹贰线报 · 真免费、真核实、不误导。


版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。