JEECG-Boot项目离线模式下图标加载问题解决方案

问题背景

在JEECG-Boot 3.7.0版本中，当开发者在本地VSCode启动模式下运行项目时，系统会尝试从远程服务器加载部分图标资源。特别是在内网部署环境下，这种远程请求会导致图标加载失败，影响用户体验。

问题现象分析

1. 远程请求现象：在离线模式下，系统会向api.iconify.design/ant-design.json发起多个远程请求
2. 图标加载差异：
   • 系统内置的mdi:chevron-down图标可以正常本地加载
   • 但替换为mdi:chevron-double-down后就需要远程加载

技术原理

JEECG-Boot项目使用了图标管理系统，默认情况下：

1. 部分常用图标已内置在项目中
2. 其他图标会通过CDN动态加载
3. 图标库采用按需加载机制，未使用的图标不会打包进项目

解决方案

方案一：使用本地化图标生成工具

JEECG-Boot提供了专门的图标本地化工具，可以将需要的图标生成本地资源：

1. 准备需要使用的所有图标名称列表
2. 运行图标生成工具
3. 工具会自动下载指定图标并转换为本地资源
4. 将生成的资源文件放入项目指定目录

方案二：手动添加图标资源

对于少量新增图标，可以手动处理：

1. 从图标库官网下载SVG格式图标
2. 将SVG文件放入项目资源目录
3. 在代码中引用本地SVG资源
4. 配置图标别名方便调用

方案三：完整图标库本地化

如需完整本地化整个图标库：

1. 下载完整的图标库资源包
2. 配置项目禁用CDN加载
3. 修改图标加载配置指向本地资源
4. 优化打包配置确保图标资源正确包含

实施建议

1. 开发阶段：建议使用方案一，通过工具自动化处理
2. 生产环境：推荐方案三，确保所有图标资源本地化
3. 临时解决方案：可使用方案二快速解决特定图标问题

注意事项

1. 图标本地化会增加项目体积，需权衡利弊
2. 定期更新本地图标库以获取最新图标
3. 测试不同分辨率下的图标显示效果
4. 注意图标授权问题，确保商业使用合规

通过以上方案，开发者可以彻底解决JEECG-Boot项目在离线环境下的图标加载问题，确保系统在内网环境中的稳定运行。