本地可运行但GitHub PR报错无法Tree Shake图标字体：原因与修复

本地运行Flutter应用正常，但提交PR到GitHub后，检查环节报错：

"This application cannot tree shake icons fonts. It has non-constant instances of IconData at the following locations: Product_Model"

相关代码片段：

class ProductModel extends Equatable {
  final DocumentReference selfRef;
  final String productName;
  final String description;
  final DocumentReference defaultPlan;
  final IconData icon;
  const ProductModel(
      {required this.selfRef,
      required this.productName,
      required this.defaultPlan,
      required this.icon,
      required this.description});
  factory ProductModel.fromSnapshot(
      DocumentSnapshot<Map<String, dynamic>> snapshot) {
    final data = snapshot.data()!;

    return ProductModel(
        selfRef: snapshot.reference,
        productName: data['name'] as String,
        defaultPlan: data['defaultPlan'],
        icon: IconData(data['iconId'] as int, fontFamily: 'MaterialIcons'),
        description: data['description'] as String);
  }

 @override
  List<Object> get props => [selfRef, productName, defaultPlan, icon];
}

1. 编译配置差异：本地默认编译未开启严格的图标树摇（tree shaking）检查，而GitHub CI的检查环节启用了Flutter的--tree-shake-icons编译选项。这个选项要求所有IconData必须是编译时常量，只有常量实例才能被正确识别并剔除未使用的图标字体，从而减小包体积。
2. 动态创建实例违规：在fromSnapshot工厂方法中，你通过IconData(data['iconId'] as int, fontFamily: 'MaterialIcons')动态生成IconData实例，该实例不是编译时常量，违反了--tree-shake-icons的检查规则，因此CI环节报错；本地未启用该选项，所以能正常运行。

有两种可行方式，可根据业务需求选择：

方式一：预定义常量IconData映射表 #

将业务中所有可能用到的图标ID与对应常量IconData做映射，避免动态创建：

// 预定义所有业务用到的图标常量映射
const Map<int, IconData> productIcons = {
  59467: Icons.shopping_bag,
  62159: Icons.laptop,
  // 补充所有实际用到的图标ID与对应IconData
};

class ProductModel extends Equatable {
  final DocumentReference selfRef;
  final String productName;
  final String description;
  final DocumentReference defaultPlan;
  final IconData icon;
  const ProductModel(
      {required this.selfRef,
      required this.productName,
      required this.defaultPlan,
      required this.icon,
      required this.description});
  factory ProductModel.fromSnapshot(
      DocumentSnapshot<Map<String, dynamic>> snapshot) {
    final data = snapshot.data()!;
    final iconId = data['iconId'] as int;
    // 从预定义映射表中获取常量IconData，提供默认图标兜底
    final icon = productIcons[iconId] ?? Icons.error_outline;

    return ProductModel(
        selfRef: snapshot.reference,
        productName: data['name'] as String,
        defaultPlan: data['defaultPlan'],
        icon: icon,
        description: data['description'] as String);
  }

 @override
  List<Object> get props => [selfRef, productName, defaultPlan, icon];
}

这种方式完全符合树摇要求，CI检查会通过，同时不影响业务逻辑，是推荐方案。

方式二：禁用CI的图标树摇检查 #

如果业务必须动态创建IconData，可以修改GitHub CI配置文件（如.github/workflows/xxx.yml）中的编译命令，移除--tree-shake-icons选项：
将原来的命令：

flutter build --tree-shake-icons

改为：

flutter build

但这种方式会导致图标字体无法被树摇，最终应用包体积增大，仅适合特殊场景使用。

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