直接删掉重复引入的图标 CSS 文件，统一用 uni_modules 或 npm 管理可解决 90% 图标库冲突；因 .icon-home 等类名是全局作用域，多文件同名 class 会覆盖，且加载顺序不可控，导致方块、错位、不渲染等问题。
直接删掉重复引入的图标 CSS 文件，再统一走 uni_modules 或 npm 包管理，基本就能解决 90% 的图标库冲突问题。手动复制 iconfont.css 是根源，不是临时 patch 能治好的。
为什么 iconfont.css 多次引入会冲突
图标类名（如 .icon-home）是全局作用域，多个 CSS 文件里定义同名 class，后加载的会覆盖前一个——但加载顺序受构建工具、平台（H5/App/小程序）和 easycom 配置影响，不可控。
- 常见错误现象：
uni-icons和你手动引入的iconfont.css同时存在，结果图标显示为方块或错位 - 使用场景：团队协作中有人加了新图标，直接覆盖
static/iconfont.css，而别人本地还保留旧版 - 性能影响：Webpack 分析显示，重复引入的图标 CSS 平均造成 40% 的样式体积冗余
- 关键点：小程序端更敏感，
cover-view里用图标时若 class 冲突，可能直接不渲染
如何用 uni_modules 统一管理图标库
把图标库作为插件放进 uni_modules 目录，uni-app 编译器会自动去重、按需注入，且不污染全局 CSS。
- 操作步骤：从 iconfont 官网导出项目 → 解压后重命名为
uni-iconfont→ 放入项目根目录uni_modules/uni-iconfont - 必须包含：
package.json（含"name": "uni-iconfont"）、static/iconfont.ttf、components/uni-iconfont/uni-iconfont.vue - 禁用所有
static/下的iconfont.css引用，包括main.js里的import './static/iconfont.css' - 引用方式改为组件调用：
<uni-iconfont name="home" />，不再依赖 class 名
npm 包方式引入时的依赖冲突检查
如果你用的是私有 npm 图标包（比如 @company/iconfont），要注意它是否与 uni-ui 或 uView 自带的图标逻辑打架。
- 典型表现：
Failed to resolve component: uni-icons或控制台报Duplicate class .uni-icon - 检查方法：运行
npx depcheck，确认没有多个包同时导出iconfont.css或声明@font-face - 参数差异：
uni-ui的图标是 SVG 内联，而 iconfont 是字体，二者不能混用同一套 class 前缀 - 兼容性处理：在
vue.config.js中配置configureWebpack.resolve.alias，把旧路径指向新包，避免相对路径残留
最常被忽略的是：图标字体文件（.ttf）的路径是否被 Webpack 正确识别为资源，而不是当作普通文本打包进 JS —— 这会导致真机上图标空白。务必检查构建产物中 static/ 下是否有该字体文件，且 @font-face 的 src 路径能被运行时正确解析。
