Dart 3.0 强制要求项目开启空安全：迁移指南与 SDK 版本适配

Dart 3.0 完全移除了对非空安全代码的支持，因此项目 pubspec.yaml 中的 SDK 约束必须升级至 >=2.12.0 <3.0.0，并完成完整的空安全迁移，否则 flutter pub get 将失败（如错误码 614）。

dart 3.0 完全移除了对非空安全代码的支持，因此项目 `pubspec.yaml` 中的 sdk 约束必须升级至 `>=2.12.0

Dart 3.0 是一个里程碑式版本——它完全弃用非空安全模式，不再兼容任何未迁移至空安全（Null Safety）的 Dart 代码。这意味着：即使你的本地 Flutter SDK 显示为 3.0.0（对应 Dart 3.0），只要 pubspec.yaml 中声明的 SDK 下限低于 2.12.0（例如 >=2.10.0 <3.0.0），flutter pub get 就会报错：

The lower bound of "sdk: '>=2.10.0 <3.0.0'" must be 2.12.0 or higher to enable null safety.

该错误并非配置语法问题，而是 Dart 工具链的强制校验机制：Dart 3.0 运行时仅接受已启用空安全的代码，而空安全自 Dart 2.12 起成为默认且不可绕过的功能。

✅ 正确的 SDK 约束应修改为：

environment:  sdk: ">=2.12.0 <3.0.0"  # 注意：下限必须 ≥2.12.0

⚠️ 但仅修改 pubspec.yaml 并不足够！>=2.12.0 仅表示“允许使用空安全”，不代表项目已实际启用空安全。你需要完成完整的迁移流程：

1. 检查当前迁移状态

运行以下命令，查看哪些文件尚未迁移：

dart migrate --show-all

或在 VS Code 中右键项目根目录 → “Dart: Start Null Safety Migration”。

2. 分阶段迁移（推荐）

大型项目（如含 614 个文件）切忌一次性强制迁移。建议：

• 使用 --skip-imports 跳过第三方依赖分析；
• 优先处理核心业务模块（如 lib/main.dart, lib/models/, lib/services/）；
• 对每个文件手动添加 // @dart=2.12（临时兼容），再逐步移除并修复空值警告；
• 善用 !、?、late、required 和可空类型（如 String?）重构逻辑。

3. 验证与清理

迁移完成后，确保：

• 所有 .dart 文件顶部无 // @dart=2.9 等降级注释；
• analysis_options.yaml 中启用了空安全相关 lint 规则（如 unnecessary_null_comparison）；
• 运行 flutter analyze 和 flutter test 确认无空安全相关错误。

? 重要提醒：

• Flutter 3.10+ 默认绑定 Dart 3.0，无法回退到 Dart 2.x；
• 第三方包若未支持空安全，需升级至兼容版本（检查 pub.dev 的 “Null safety” 标签）；
• 若遇阻塞性依赖（如某包仍为 sdk: ">=2.7.0 <3.0.0"），可暂时 fork 修改其 pubspec.yaml 并引用本地路径，但长期应推动上游维护者发布 null-safe 版本。

完成迁移后，再次执行 flutter clean && flutter pub get，错误 614 将彻底消失——你将获得更健壮、可静态分析的 Dart 3 代码基线。