vue项目引入svg图标（完整步骤）

最新推荐文章于 2025-06-08 22:10:12 发布

小小弯_Shelby

最新推荐文章于 2025-06-08 22:10:12 发布

阅读量2.5w

点赞数 32

CC 4.0 BY-SA版权

分类专栏：前端文章标签： vue.js javascript 前端

本文链接：https://blog.youkuaiyun.com/weixin_44293690/article/details/126304407

前端专栏收录该内容

29 篇文章

订阅专栏

本文详细介绍如何在Vue项目中集成SVG图标，包括安装依赖、配置文件夹、配置webpack、自动导入图标及创建SVG组件等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 安装svg依赖

在vue中首先需要安装可以加载svg的依赖。
npm安装：npm install svg-sprite-loader --save-dev

2. 创建svg文件夹存放svg图标

创建icons文件夹，在icons文件夹下创建svg文件夹存放本地svg图标。
在这里插入图片描述

3. vue.config.js 中配置svg图片

在这里插入图片描述
vue.config.js代码：

const path = require('path')

module.exports = {
  chainWebpack:config=>{
    // svg图标加载
    config.module
      .rule('svg')
      .exclude.add(path.join(__dirname, 'src/assets/icons/svg'))
      .end()

    config.module
      .rule('icons')// 定义一个名叫 icons 的规则
      .test(/\.svg$/)// 设置 icons 的匹配正则
      .include.add(path.join(__dirname,'src/assets/icons/svg'))// 设置当前规则的作用目录，只在当前目录下才执行当前规则
      .end()
      .use('svg-sprite')// 指定一个名叫 svg-sprite 的 loader 配置
      .loader('svg-sprite-loader')// 该配置使用 svg-sprite-loader 作为处理 loader
      .options({// 该 svg-sprite-loader 的配置
        symbolId:'icon-[name]'
      })
      .end()
  }
}

include.add(路径)–路径不正确会报以下错误：
在这里插入图片描述

4. 创建index.js 导入所有svg图标

icons文件夹创建index.js 自动导入所有svg图标。
在这里插入图片描述
icons/index.js代码：

const req = require.context('@/assets/icons/svg',false,/\.svg$/)
const requireAll = requireContext =>{
    // requireContext.keys()数据：['./404.svg', './agency.svg', './det.svg', './user.svg']
    requireContext.keys().map(requireContext)
} 
requireAll(req)

执行 requireContext.keys().map(requireContext)得到返回的数据：
在这里插入图片描述

5. main.js中引入icons/index.js

在这里插入图片描述

6. 创建SvgIcon公用组件

在这里插入图片描述
SvgIcon/index.vue代码：

<template>
    <i v-if="iconFileName.indexOf('el-icon-') === 0" :class="iconFileName" />
    <svg v-else class="svg-icon" aria-hidden="true" v-on="$listeners">
        <use :xlink:href="`#icon-${iconFileName}`" />
    </svg>
</template>

<script>
export default {
    name: 'SvgIcon',
    props: {
        iconFileName: {
            type: String,
            required: true
        }
    }
}
</script>

<style scoped>
.svg-icon {
    width: 1em;
    height: 1em;
    overflow: hidden;
    vertical-align: -0.15em;
    fill: currentColor;
}
</style>