Flutter中CheckboxListTile国际化翻译遇到文本非空报错如何解决？

该报错的核心是Text组件接收到了空字符串参数，问题出在AppLocalizations.of(context).translate()的返回值为null，常见触发场景如下：

• 传入的翻译keyDo you accept the terms and conditions?未在对应语言配置文件中注册，找不到匹配翻译返回null
• AppLocalizations.of(context)返回null，当前context不在本地化组件作用域内，MaterialApp的本地化配置有误
• 自定义的translate方法未做空值兼容，找不到key时直接返回null

1. 优先添加空值兜底 #

先给翻译返回值加非空兜底，保证Text组件不会接收到null，同时适配新版Flutter中onChanged参数的可空类型要求，修复后代码如下：

CheckboxListTile(
  value: agree,
  title: Text(
    AppLocalizations.of(context)?.translate('Do you accept the terms and conditions?') ?? 'Do you accept the terms and conditions?',
    style: const TextStyle(fontSize: 18),
  ),
  onChanged: (bool? value) {
    if (value != null) {
      setState(() {
        agree = value;
      });
    }
  },
);

2. 检查本地化基础配置 #

确认你的MaterialApp已经正确配置本地化参数：

MaterialApp(
  localizationsDelegates: const [
    AppLocalizations.delegate,
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: const [
    Locale('en', ''),
    Locale('zh', ''),
    // 你项目支持的其他语言配置
  ],
  // 其他项目配置
)

3. 补全翻译key配置 #

检查所有语言的配置文件（如intl方案的arb文件、自定义的本地化映射表），确保Do you accept the terms and conditions?这个key在所有支持的语言中都有对应的非空翻译值，示例arb配置如下：
en.arb配置：

{
  "Do you accept the terms and conditions?": "Do you accept the terms and conditions?"
}

zh.arb配置：

{
  "Do you accept the terms and conditions?": "你是否接受服务条款？"
}

4. 优化translate方法的空处理 #

可直接修改自定义的translate方法，找不到对应key时默认返回key本身，避免每次调用都需要做空判断：

String translate(String key) {
  return _localizedStrings[key] ?? key;
}

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