vue3使用vite构建如何引入svg图标

强烈推荐使用 vite-svg-loader库。该库每周 npm 下载量大概12w,目前版本已经更新到了 5.1.0,使用方式极其简单,官方文档示例清晰易懂。

本文将简单介绍一下该库的使用方法,更多进阶用法可自行查看官方文档。

1. 安装 vite-svg-loader 库

bash 复制代码
npm install vite-svg-loader --save-dev

2. 在 vite.config 中注册

js 复制代码
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

import svgLoader from 'vite-svg-loader'

export default defineConfig({
  plugins: [
      vue(), 
      svgLoader()
  ]
}

3. 在组件中使用 svg 图标

直接在组件的 script 中引入图标即可在 template 中使用,像引入组件一样。

vue3 复制代码
<script setup>
import IconTest from '@/assets/svg/test.svg'
<script>

<template>
    <IconTest />
</template>

4. 注意事项

如果你想要图标的颜色、大小,自动跟随字体的颜色、大小,那么你可能需要修改下载的 svg 文件。

  • 在 svg 元素上添加一个 fill="currentColor" 属性,并移除 path 元素上的 fill 属性。如下图:

  • 或者,在 svg 元素上添加一个 class="svg-icon" 属性,也要移除 path 元素上的 fill 属性,最好将设置这个类的样式文件全局引入(也可以将这个类添加在 app.vue 中)。样式内容如下:

    css 复制代码
    .svg-icon {
      width: 1em;
      height: 1em;
      fill: currentColor;
    }

主要参考了 vite-svg-loader 的官方文档

相关推荐
Andrew55133 分钟前
让 AI 写页面不再“一眼假”:我把设计品味做成了一个 Claude Code Skill 流水线
前端
乐享qicheng35 分钟前
14-AI智能管家JSBridge深度问答
前端
10年前端老司机1 小时前
我用 Vue3 + LangGraph 做了个心理咨询 AI,踩了 9 个坑后总结出来的实战经验
前端·langchain·agent
数据掘金1 小时前
A/B 实验分组参数回滚后还在生效?一次参数校验体系的重构复盘
前端
bmxy小明同学1 小时前
2026-10-09-token与成本
java·前端·数据库
neoooo2 小时前
🚀Claude Code 小技巧(二):找回会话,撤销修改
前端·人工智能·后端
今年下半年2 小时前
【文件上传】记录一次大附件上传的处理方案
前端·文件上传·内存溢出·分段上传
溪语流沙2 小时前
【每天一个CSS | Day21】落地页Hero动画的分镜表
前端·css
neoooo2 小时前
🚀Claude Code 小技巧(一):一键进入危险模式
前端·人工智能·后端
bmxy小明同学3 小时前
2026-10-11-幻觉治理
服务器·前端·javascript