Windows环境下配置Flutter启动图标时运行flutter_launcher_icons出现预编译失败问题

核心报错原因 #

• 版本配置冲突：pubspec.yaml中同时在dependencies和dev_dependencies两个节点声明了flutter_launcher_icons依赖，且版本范围不一致，导致pub拉取的依赖出现混乱。
• 依赖包缺失：报错提示找不到image-2.1.19包，该版本是flutter_launcher_icons 0.8.x的必需运行依赖，本地pub缓存中没有对应版本的包文件，导致插件预编译时无法导入依赖库。

排查解决步骤 #

1. 清理冲突的依赖配置
   打开pubspec.yaml，删除dependencies节点下多余的flutter_launcher_icons: ^0.8.1，该插件属于开发工具，仅需在dev_dependencies中声明即可。
2. 统一插件版本并修复缓存
   • 调整dev_dependencies中的插件版本为固定值，如flutter_launcher_icons: 0.8.1（去掉版本范围的^约束，避免pub拉取不兼容的小版本）
   • 依次执行命令清理项目和缓存：

     flutter clean
     flutter pub cache repair
     

3. 重新执行生成图标流程
   依次执行命令拉取依赖、运行插件：
   • flutter pub get
   • flutter pub run flutter_launcher_icons:main
4. 兜底方案：手动指定依赖版本
   如果上述步骤仍报错，在dev_dependencies中手动添加插件需要的image包版本：

   dev_dependencies:
     image: 2.1.19
   

   再重新执行flutter pub get和插件运行命令即可。

注意事项 #

• 若后续升级flutter_launcher_icons到0.9.0及以上版本，需要将原flutter_icons配置节点替换为flutter_launcher_icons，否则插件无法识别配置。
• 确保image_path指向的图标文件真实存在，路径与assets配置匹配，避免生成图标时出现找不到文件的报错。

内容的提问来源于stack exchange，提问作者Michael Ogundipe