Dart字符串插值报错：无效常量值问题咨询

一、Dart常量字符串插值的规则 #

Dart并非要求所有插值字符串必须是常量——只有当你显式标记字符串为const时，才会强制要求插值内容必须是编译时常量（比如字面量、const变量、编译期可计算的表达式）。这是因为const值是在编译阶段就确定的，无法包含运行时才能生成的内容（比如DateTime.now()、动态获取的变量值）。如果你的插值字符串不需要作为常量使用，完全可以去掉const修饰，直接用运行时变量插值，这完全符合字符串插值的设计目标。

二、关于Text组件的构造函数 #

Text组件有两种构造逻辑：

• 普通构造：Text(String data)，这里的data可以是任何运行时生成的字符串，没有常量要求；
• const构造：const Text(String data)，这种构造是为了组件复用优化，要求data必须是编译时常量。如果你用了const Text，但传入的是运行时插值生成的字符串，就会触发报错。你觉得“不合理”，大概率是误加了const修饰符。

三、结合你的代码分析 #

你提供的Document类代码本身没有问题：

class Document 
{
  final Map<String, Object?> _json;
  Document() : _json = jsonDecode(documentJson);

    ({String title, DateTime modified}) get metadata 
    {     
      const title = 'My Document';
      final now = DateTime.now();
      return (title: title, modified: now);
    }  
}

问题应该出在你使用metadata的场景中——比如如果是这样写：

const Text("标题：${document.metadata.title}")

这里的document.metadata是运行时获取的（即使title是const，但整个表达式是运行时求值），用const Text就会触发“无效常量值”的报错。

四、修复方案 #

• 去掉Text组件的const修饰符，改用普通构造：

  Text("标题：${document.metadata.title}")
  

• 检查所有标记了const的字符串插值场景，确保插值内容都是编译时常量；如果包含运行时变量，直接去掉const即可。

内容的提问来源于stack exchange，提问作者László Frank