被leader多次吐槽的elementUI 图标乱码问题终于解决了

现象:图标乱码

参与做的Vue2+elementUI的项目中,图标偶尔会出现乱码的情况(刷新后就正常了),如下图。

一开始以为是阿里图标库的问题,因为上图中的图标我们是从阿里图标库引入的,而不是elementUI自带的。

然后我们就把阿里图标库的引入方式由在线引入改为存到本地使用,但是乱码问题依然存在。

本质:编译问题

在网上一番搜索,终于找到出现乱码的原因,是sass编译的问题。

.scss文件中通过伪元素方式添加的图标,经过sass编译后,样式中的content会变成乱码,如下:

(el-select组件使用elementUI自带的图标)

(el-select组件使用阿里图标库的图标)

el-select组件使用阿里图标库的图标经项目中的sass编译产生问题还能理解,那为什么el-select组件使用elementUI自带的图标也会产生编译问题呢?

因为项目中引用elementUI时,需要改主题色,就引入了包含了icon.scss的elementUI scss样式文件,该文件经过sass 会重新编译。但如果引入的是elementui 编译后的css 文件,sass就不会再编译了。

解决:两种策略

一、更改写法:通过伪元素方式添加的图标均放到.css文件中,不用sass写法。

1.如果项目中在使用elementUI组件时直接用组件自带的图标,则只需在main.js中加入如下代码即可:

arduino 复制代码
import 'element-ui/lib/theme-chalk/icon.css'

前提是检查element-ui/packages/theme-chalk/src/index文件中,是否引入了icon.scss文件。

如果未引入,则直接加如上一行代码就行。

如果引入了,则还需要修改项目里自定义element-ui主题的文件element-variables.scss。这个文件里本来有一个引入所有element组件scss文件的一行代码,如下。

scss 复制代码
@import "~element-ui/packages/theme-chalk/src/index";

把这一行去掉,然后直接引入所有的scss文件,除了icon.scss。

如下:

scss 复制代码
​
@import "~element-ui/packages/theme-chalk/src/common/transition.scss";
@import "~element-ui/packages/theme-chalk/src/pagination.scss";
@import "~element-ui/packages/theme-chalk/src/dialog.scss";
@import "~element-ui/packages/theme-chalk/src/autocomplete.scss";
...

2.如果项目中有在.scss文件中通过伪元素方式添加图标,则需要单独建立一个icon.css文件,把所有sass写法的图标改成css写法并放到icon.css文件中,然后再在main.js文件中引入:

arduino 复制代码
import './styles/icon.css'

检查自己的项目,按照以上操作,即可解决问题。

二、升级版本,添加配置
  1. 将sass升级到1.39.0及以上版本

  2. vue.config.js添加配置:

    css 复制代码
    module.exports = {
        ...
        css: {
            loaderOptions: {
              scss: { 
                sassOptions: { outputStyle: 'expanded' } 
              }
            }
          },
          ...
    }

    若编译时出现如下提示

    vbnet 复制代码
    DEPRECATION WARNING: Using / for division is deprecated and will be removed in Dart Sass 2.0.0.

    则执行以下命令:

    ruby 复制代码
    $ npm install -g sass-migrator
    $ sass-migrator division **/*.scss

    具体参考:blog.csdn.net/qq_38951259...

    按照此方法,同样可以解决问题。

三、其他

1.因项目中使用的sass默认是dart-sass,而elementUI中用的是node-sass。所以有网友建议卸载sass,安装node-sass。

2.还有网友建议保持已有的sass,然后安装css-unicode-loader插件,安装后在webpack配置针对scss、sass的文件loader中,在sass-loader前加上css-unicode-loader。

这两种方式我也尝试了一下,但是没有成功,有兴趣的可以去试试。

验证:两种方式

一. 按F12打开控制台,看样式代码

如果对应图标的content像图中显示,则代表正常了,不乱码了。

二、按F12后再多次按F5刷新

找到问题页面,按F12打开控制台后,如果多次刷新页面,图标都正常,说明乱码问题修复了。

相关推荐
0xBADCODE1 小时前
2026 强网杯 Web 题 cwp · 全链路复盘
前端·安全·web安全·网络安全·系统安全·ctf
麦麦麦当劳大王10 小时前
【油猴脚本】Boss直聘 岗位职责复制
开发语言·前端·javascript
小lu飞11 小时前
2026小红书小工具怎么制作:纯前端 ZIP 打包、沙箱限制与笔记挂载流程
前端·笔记·ai·ai编程
smallcelebration11 小时前
151 从0开始搭建后端项目
前端·firefox
wangruofeng11 小时前
手机和电脑传文件,除了微信还有 LocalSend
前端
excel12 小时前
基于 GPT 的自动发布文章接口方案:从一句话或一张图片生成并发布内容
前端·javascript·后端
其实防守也摸鱼13 小时前
个人学习 Pwn 思路:从基础到漏洞利用的进阶路径
大数据·前端·人工智能·chrome·算法·安全·网络安全
朱涛的自习室14 小时前
212 个需求、22 万行代码:Agent 接管开源项目的 19 天
android·前端·人工智能
aZhe的全栈知识分享14 小时前
AI 还原 Figma 效果总达不到预期?先别急着让它写代码
前端·后端·面试
review4454314 小时前
Codex Hooks 入门实战:生命周期事件、matcher 与5分钟跑通一个钩子
前端·agent·vibecoding