如何将基于Flutter 3.7.12的旧项目迁移至Dart 3？

安全阿岳

2026-7-14

Flutter 项目迁移至 Dart 3 空安全的自动化终端方案

无法通过单一终端命令完成全部迁移，但Dart和Flutter官方提供的自动化工具能帮你大幅减少手动修改工作量，步骤如下：

升级Flutter至最新稳定版
执行终端命令完成升级：
```
flutter upgrade
```
升级后通过flutter --version确认绑定的Dart版本为3.x（最新Flutter稳定版默认搭载Dart3）。
更新SDK约束并启动迁移工具
1. 手动修改项目根目录的pubspec.yaml，将SDK约束改为适配Dart3的版本：
```
environment:
  sdk: ">=3.0.0 <4.0.0"
```
2. 在项目根目录执行空安全迁移命令：
```
dart migrate
```
  工具会扫描所有代码文件，识别空安全相关的修改点，并生成一个本地预览链接（通常为http://127.0.0.1:8080）。打开该链接后，你可以批量应用工具的自动修复建议，覆盖绝大多数变量可空性、返回值类型等基础修改。
处理剩余未自动修复的问题
自动工具无法覆盖所有场景（比如业务逻辑相关的可空判断、第三方依赖不兼容空安全等）：
1. 执行代码分析命令定位剩余问题：
```
flutter analyze
```
2. 根据分析结果逐一修复错误；对于第三方依赖，需升级至支持空安全的版本后执行flutter pub get更新依赖。
验证迁移结果
运行项目和测试确保无异常：
```
flutter run
flutter test
```