Flutter Icon组件显示图标与指定Icons枚举值不符问题求助

问题表现 #

指定 Icon 组件的图标参数为特定 Icons 枚举值后，实际渲染出的图标与预期完全不一致，问题同时会影响框架自带 Widget（如日历组件）的图标显示。
示例代码：

Icon(
  Icons.ac_unit
),

上述代码预期显示 ac_unit 雪花图标，实际渲染为其他无关图标。

触发原因 #

• 项目编译缓存或 pub 依赖缓存异常，导致 Material 图标枚举值与字体资源映射偏移
• pubspec.yaml 未开启 Material 设计支持配置，图标资源未完整打包
• 编译过程中 Material Icons 字体文件损坏
• 当前使用的 Flutter SDK 为非正式稳定版，存在已知图标映射 Bug

修复步骤 #

1. 清理项目缓存并重新编译 #

依次执行以下命令：

flutter clean
flutter pub get
flutter run

桌面端、Web 端项目可先手动删除对应平台的构建目录后再执行上述命令，避免残留缓存影响。

2. 校验 pubspec.yaml 配置 #

确认配置文件中已开启 Material 资源引入：

flutter:
  uses-material-design: true

该配置为必填项，缺失会导致系统仅打包部分图标资源，出现图标映射错位问题。

3. 切换 Flutter SDK 至稳定渠道 #

如果当前使用的是 dev、beta 渠道的测试版 SDK，执行以下命令切换至正式稳定版：

flutter channel stable
flutter upgrade

升级完成后重新清理编译项目即可。

4. 修复全局 pub 缓存 #

上述方案无效时，执行命令修复全局依赖缓存：

flutter pub cache repair

执行完成后重新拉取项目依赖并编译即可解决问题。

内容的提问来源于stack exchange，提问作者Zach Gonzalez