Flutter如何禁用指定测试用例？实现仅手动可执行的测试管控

问题背景 #

我们有一个对接后端服务的Flutter应用，调试时需要可手动运行的测试用例，但在构建流水线中希望禁用这些测试，避免后端服务不可用时导致构建失败。我们希望测试用例保留在项目中，仅在手动启用时执行。

习惯Java中的@Disabled注解（可用于测试类或单个测试），想知道Flutter是否有类似机制。曾尝试@Skip，但IDE提示其仅适用于库且无效果。

目前采用的临时方案如下，但会触发“dead code”警告：

void main() {
  const disabled = true; //These tests are only for manual use

  if (!disabled) {
    initializeGetItContext();

    test("Some Test", () async {
      //Test Logic
    });

    test("Some Other Test", () async {
      //Test Logic
    });
  }
}

最优实现方案 #

方案1：使用test函数的skip参数（官方推荐） #

Flutter的test原生支持skip参数，可单独控制单个测试，也能批量统一管理，完全替代Java的@Disabled：

单个测试禁用

直接给目标测试添加skip: true即可跳过：

test("Some Test", () async {
  // 测试逻辑
}, skip: true);

批量控制测试组

用一个常量统一控制一组测试的启用状态，不会触发死代码警告：

// 手动调试时改为false，构建流水线保持true
const skipManualTests = true;

void main() {
  initializeGetItContext();

  test("Some Test", () async {
    // 测试逻辑
  }, skip: skipManualTests);

  test("Some Other Test", () async {
    // 测试逻辑
  }, skip: skipManualTests);
}

方案2：分组控制测试 #

如果需要把相关测试归类管理，用group函数结合skip参数可以一键控制整个测试组：

const enableManualTests = false;

void main() {
  group('后端对接手动测试', () {
    initializeGetItContext();

    test("接口A测试", () async {
      // 测试逻辑
    });

    test("接口B测试", () async {
      // 测试逻辑
    });
  }, skip: !enableManualTests); // 仅当enableManualTests为true时执行该组测试
}

方案3：编译条件自动适配环境 #

如果想要无需手动修改常量，让测试在debug模式自动启用、构建流水线自动禁用，可使用Flutter的assert特性：

void main() {
  // assert代码块仅在debug模式执行，release模式会被自动移除
  assert(() {
    initializeGetItContext();

    test("Some Test", () async {
      // 测试逻辑
    });

    test("Some Other Test", () async {
      // 测试逻辑
    });
    return true;
  }());
}

构建流水线通常使用release模式构建，因此这些测试不会被执行；本地debug调试时，测试会正常运行。

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