如何在同名方法中引用同一模块内的顶层函数？

问题场景 #

当类中的方法与顶层函数同名时，方法会隐藏顶层函数，示例代码如下：

void test() {}

class A {
  void test() {
    // 此处希望调用上方的顶层test()，而非当前类的test()方法
  }
}

如何在类的test()方法内部引用顶层的test()函数？

我自行实现了一种方式，但需要硬编码当前源文件名，想了解是否有更优方案：

// 源文件名为'test.dart'
import 'test.dart' as thisModule;

void test() {}

class A {
  void test() {
    thisModule.test();
  }
}

注：曾有类似问题针对核心print()函数与自定义print()方法，但本次场景中两个符号均为用户定义，核心需求是避免硬编码文件名。

解决方案 #

在Dart中，除了上述硬编码文件名导入自身的方式，还有两种更合理的方案可以解决这个问题：

方案1：用静态类封装顶层函数 #

将顶层函数封装到一个静态工具类中，通过类名直接调用，从根源避免命名冲突：

class TopUtils {
  static void test() {}
}

class A {
  void test() {
    TopUtils.test(); // 明确调用静态类中的顶层逻辑
  }
}

这种方式不仅彻底解决了同名冲突，还提升了代码可读性，后续维护时能清晰区分不同作用域的函数。

方案2：拆分至独立库文件 #

如果不想改动原有顶层函数的写法，可将顶层函数单独放到一个库文件中，再在主文件中通过前缀导入调用：

// top_functions.dart（独立库文件）
void test() {}

// 主文件
import 'top_functions.dart' as top;

class A {
  void test() {
    top.test(); // 通过前缀调用独立库中的顶层函数
  }
}

这种方式虽然仍需指定文件名，但指向的是独立的功能模块，逻辑划分更清晰，也规避了导入自身的非常规写法。

补充说明：目前Dart语言本身并未提供直接引用当前库顶层函数的专属语法（类似面向对象中的super），因此上述两种方案是更优的替代选择。

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