Flutter如何仅为Debug构建添加资源或从Release构建移除？

1. 仅为Debug构建添加资源/从Release中剔除特定资源 #

完全可以实现，推荐两种实用方式：

• 条件式资源配置（Flutter 3.7+）
  在pubspec.yaml中利用Flutter的条件assets语法，只在非Release模式下包含截图专用资源：

  flutter:
    assets:
      - assets/common/
      # 仅Debug/Profile模式包含截图资源
      - if (dart.vm.product == false):
          - assets/screenshot_only/
  

  dart.vm.product为true时对应Release构建，false对应Debug/Profile，Release包会自动忽略这些资源。

• 通过dart-define灵活控制
  若需要更灵活的开关，可在构建时传入参数，比如Debug构建时执行：

  flutter run --dart-define=INCLUDE_SCREENSHOT_ASSETS=true
  

  然后在pubspec.yaml中对应配置：

  flutter:
    assets:
      - assets/common/
      - if (dart-defines: INCLUDE_SCREENSHOT_ASSETS=true):
          - assets/screenshot_only/
  

2. Debug/模拟器下从项目目录加载图片 #

模拟器环境中，可直接通过dart:io的File类读取项目本地图片，无需打包进assets：

import 'dart:io';
import 'package:flutter/foundation.dart';
import 'package:flutter/widgets.dart';

Widget loadScreenshotImage(String fileName) {
  if (kDebugMode) {
    // 模拟器下直接加载项目目录中的图片路径
    final imageFile = File('assets/screenshot_only/$fileName');
    if (imageFile.existsSync()) {
      return Image.file(imageFile);
    }
  }
  // Release或真机Debug下返回占位/空组件
  return const SizedBox.shrink();
}

注意：真机Debug模式无法直接访问电脑端的项目目录，这种场景建议用条件assets打包资源，或临时通过网络加载测试图片。

3. 借助测试文件夹实现需求 #

测试文件夹（test/）下的资源默认不会被打包进Release构建，非常适合存放这类仅用于开发/测试的资源：

• 将截图资源放在test/resources/screenshots/目录下
• 在pubspec.yaml中配置仅Debug模式包含该目录：

  flutter:
    assets:
      - if (dart.vm.product == false):
          - test/resources/screenshots/
  

• 代码中通过AssetImage加载即可，和普通assets用法一致：

  if (kDebugMode) {
    return Image.asset('test/resources/screenshots/home_screen.png');
  }
  

这种方式能让测试资源和主应用资源彻底分离，避免误打包。

总结建议 #

• 优先使用Flutter内置的条件assets配置，简单高效且无需额外工具
• 模拟器开发时用File直接加载项目图片，减少打包时间
• 测试文件夹是存放这类临时资源的理想位置，保持项目结构清晰
• 真机Debug如果需要使用这些资源，还是通过条件assets打包，避免路径访问问题

内容的提问来源于stack exchange，提问作者SePröbläm