Dart/Flutter 如何通过字符串变量动态调用延迟加载库

Dart 延迟加载的库前缀是编译期静态常量，Flutter 也不支持运行时反射能力，因此无法直接通过字符串拼接的方式动态触发对应库的loadLibrary()方法，手写switch分支维护成本高的问题可以通过统一注册表+可选代码生成的方案解决，完全保留延迟加载的性能收益，同时把维护成本降到最低。

核心限制说明 #

• deferred as 后的库前缀是编译期语法标记，不是运行时可通过字符串寻址的对象，直接传字符串给加载方法必然报类型错误。
• Flutter 环境下禁止使用dart:mirrors做运行时反射，该特性会大幅增加应用包体积，完全抵消延迟加载优化启动速度的效果。

具体实现步骤 #

1. 定义统一的资源结构 #

所有Nxx分组下的变量结构完全一致，先定义对应的强类型实体，避免动态拼接变量名带来的运行时错误：

/// 对应每个分组下的固定资源字段
class GroupResource {
  final Map aze;
  final List qsd;
  final List wxc;
  const GroupResource({
    required this.aze,
    required this.qsd,
    required this.wxc,
  });
}

2. 建立统一资源加载入口 #

新建resource_loader.dart作为全局资源加载入口，集中维护所有分组的延迟导入和加载映射：

// 导入所有分组的延迟库
import 'package:your_app_path/resources/N101.dart' deferred as N101;
import 'package:your_app_path/resources/N102.dart' deferred as N102;
import 'package:your_app_path/resources/N103.dart' deferred as N103;
// 后续新增分组仅需在此处追加一行导入语句

// 资源注册表：key为组件传入的kkey值，value为对应分组的加载逻辑
final Map<String, Future<GroupResource> Function()> _resourceRegistry = {
  'N101': () async {
    await N101.loadLibrary();
    return GroupResource(
      aze: N101.N101aze,
      qsd: N101.N101qsd,
      wxc: N101.N101wxc,
    );
  },
  'N102': () async {
    await N102.loadLibrary();
    return GroupResource(
      aze: N102.N102aze,
      qsd: N102.N102qsd,
      wxc: N102.N102wxc,
    );
  },
  'N103': () async {
    await N103.loadLibrary();
    return GroupResource(
      aze: N103.N103aze,
      qsd: N103.N103qsd,
      wxc: N103.N103wxc,
    );
  },
  // 后续新增分组仅需在此处追加一个对应映射条目
};

/// 对外暴露的统一资源加载方法
Future<GroupResource> loadGroupResource(String kkey) async {
  final targetLoader = _resourceRegistry[kkey];
  if (targetLoader == null) {
    throw ArgumentError('资源分组[$kkey]不存在');
  }
  return targetLoader();
}

3. 组件内调用统一加载逻辑 #

CustomButton的onPressed回调不需要再处理分支判断，直接调用统一加载方法即可：

onPressed: () async {
  final GroupResource res = await loadGroupResource(widget.kkey);
  if (!mounted) return;
  Navigator.push(
    context,
    MaterialPageRoute(
      builder: (_) => LoadingParts(
        part1: res.aze,
        part2: res.qsd,
        // 其他需要的字段直接从res对象取
      ),
    ),
  );
}

4. （可选）零维护优化：自动生成注册表 #

如果后续资源分组量级较大，可以基于Dart build_runner 写一个简易的代码生成器，自动扫描资源目录下所有符合Nxx.dart命名规则的文件，自动生成上述resource_loader.dart的全部内容。新增分组时只需要执行一行命令：

dart run build_runner build

不需要手动写任何导入或注册代码，维护成本为0。

方案优势 #

• 完全保留延迟加载的性能收益：未被访问的分组代码不会进入初始加载包，启动速度优化效果和硬编码前缀导入完全一致。
• 维护成本极低：不使用代码生成的场景下，新增分组仅需在加载入口追加2行代码，不需要修改任何业务组件逻辑；使用代码生成后完全不需要手动维护映射关系。
• 类型安全：所有资源字段都是强类型，不会出现字符串拼接变量名导致的运行时报错。

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