Flutter/Dart中如何测试增强枚举解决lcov报告未覆盖问题

在测试Dart 2.17+版本新增的增强枚举特性时，常遇到lcov覆盖率报告始终将增强枚举的定义行标记为未覆盖的问题，即便已编写枚举值相关的测试用例也无法命中该行。

问题复现 #

被测代码 #

// 普通枚举
enum AppRoutes { myRoute1, myRoute2 } // 普通枚举无覆盖率问题，无需额外测试

// 增强枚举
enum EnhancedAppRoutes { // lcov报告中该行始终被标记为未测试
  myRoute1('route1'),
  myRoute2('route2');

  const EnhancedAppRoutes(this.route); // 构造函数行可正常被覆盖

  final String route;
}

初始测试代码 #

void main() {
  group('Enum example', () {
    test('Test enum', () {
      const Enum e1 = EnhancedAppRoutes.myRoute1,
          e2 = EnhancedAppRoutes.myRoute2;

      expect(e1.runtimeType != e2.runtimeType, false);
      expect(Enum.compareByIndex(e1, e2), -1);
    });
  });
}

覆盖率报告表现 #

对应lcov.info记录显示，第5行（增强枚举定义行）执行次数为0：

SF:lib/example_enum.dart
DA:2,1
DA:5,0
DA:9,1
LF:3
LH:2
end_of_record

覆盖率报告截图：

问题原因 #

现有测试中所有枚举实例都被向上转型为Enum类型存储，没有对EnhancedAppRoutes这个增强枚举本身的类型做显式引用。增强枚举本质是携带自定义成员的特殊类，Dart的覆盖率统计逻辑会判定该类的定义行未被执行；普通枚举无自定义成员、构造函数，不会单独统计类定义行的覆盖率，因此不存在该问题。

解决方案 #

核心操作：在测试中显式引用增强枚举的类型本身，最符合测试逻辑的写法是直接校验枚举的values列表，既完成了枚举值完整性校验，又能命中定义行的覆盖率，无需写无意义的凑数代码。

修改后的完整测试代码：

void main() {
  group('Enum example', () {
    test('Test enum', () {
      // 校验values列表，显式引用增强枚举类型，覆盖枚举定义行
      expect(EnhancedAppRoutes.values, [
        EnhancedAppRoutes.myRoute1,
        EnhancedAppRoutes.myRoute2
      ]);

      const Enum e1 = EnhancedAppRoutes.myRoute1,
          e2 = EnhancedAppRoutes.myRoute2;

      expect(e1.runtimeType != e2.runtimeType, false);
      expect(Enum.compareByIndex(e1, e2), -1);
      // 补充自定义属性校验，覆盖更完整
      expect(e1.route, 'route1');
      expect(e2.route, 'route2');
    });
  });
}

补充：如果不想写values断言，也可以通过显式声明增强枚举类型的变量触发覆盖，例如写EnhancedAppRoutes? testRoute;，但这种写法属于纯凑覆盖率的无意义代码，更推荐用校验values的方式实现覆盖。

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