在Dart中全局空间为类的静态变量赋值为什么会报错？

1. 报错的直接原因 #

Dart的顶层（全局）作用域有严格的语法限制，仅允许放置声明类语句、声明函数语句、顶层变量/常量声明语句三类声明类代码，不允许直接放置普通执行语句（比如赋值语句、方法调用语句）。

你写的Name.firstName = 'Mike';属于普通赋值语句，不属于合法的顶层声明类型，编译器无法识别这类顶层执行语句，就会抛出你遇到的错误提示：

Variables must be declared using the keywords 'const', 'final', 'var', or a type name.

这个报错的本质是编译器误以为你要声明一个顶层变量，但是找不到合法的变量声明关键字，所以判定语法错误。 #

2. 特殊语法说明 #

你观察到的final me = Name();在顶层能正常运行，本质是这是顶层常量声明语句，属于合法的顶层声明类型，所以不会报错。但后续单独写的me.lastName = 'Jones';又是普通赋值语句，不符合顶层语法要求，所以依然会报错。 #

3. 规则设计的初衷 #

Dart做这个限制是为了避免文件被其他模块导入时，出现不可控的执行顺序副作用。如果允许顶层写任意执行语句，不同文件的导入顺序不同就可能导致全局状态出现预期外的差异，大幅提升调试成本和代码的不可预测性。 #

4. 官方规则出处 #

该规则在Dart官方语言规范的「顶层声明（Top-level declarations）」章节有明确说明，顶层语法单元仅支持声明类、mixin、枚举、扩展、类型别名、函数、变量/常量这几类，不支持普通表达式语句。 #

完整示例代码 #

class Name {
  static String? firstName;
  String? lastName;
}

// 顶层空间仅允许声明类、函数、顶层变量/常量
// Name.firstName = 'Mike'; // 报错：普通赋值语句不属于合法顶层声明
final me = Name(); // 正常：属于顶层常量声明语句
// me.lastName = 'Jones'; // 报错：普通赋值语句不属于合法顶层声明

void main() {
  // 函数内部允许放置任意普通执行语句
  Name.firstName = 'Mike'; // 正常
  final you = Name(); // 正常
  you.lastName = 'Smith'; // 正常
}

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