升级Flutter SDK和Gradle后VSCode调试报错：找不到no-sound-null-safety选项

截至昨天项目运行一切正常，为满足发布需求升级Flutter SDK和Gradle版本后，VSCode调试功能彻底失效，反复报错：
Could not find an option named "no-sound-null-safety".

Flutter Doctor 检测结果 #

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.10.5, on Linux Mint 21.1 5.15.0-76-generic, locale pt_BR.UTF-8)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.1)
[✓] Chrome - develop for the web
[✓] Linux toolchain - develop for Linux desktop
[✓] Android Studio (version 2022.1)
[✓] IntelliJ IDEA Ultimate Edition (version 2022.3)
[✓] VS Code (version 1.79.2)
[✓] Connected device (2 available)
[✓] Network resources

VSCode 相关配置截图 #

重启VSCode后的额外报错 #

1. 删除废弃的调试参数
   Flutter 3.0及后续版本默认启用空安全，--no-sound-null-safety参数已被移除。打开项目根目录下的.vscode/launch.json文件，找到调试配置中的该参数，直接删除对应行即可。

2. 适配项目空安全规范

• 检查代码中未初始化的变量，根据实际情况添加?（标记为可空）或!（非空断言）
• 执行flutter pub outdated查看依赖包状态，将不支持空安全的依赖升级到最新兼容版本

3. 清理缓存并重置环境
   依次执行以下命令：

flutter clean
flutter pub get

之后彻底关闭VSCode，重新打开项目再尝试调试。

4. 校验Gradle版本兼容性
   升级Gradle后，检查以下配置文件：

• android/gradle/wrapper/gradle-wrapper.properties：确保distributionUrl指向Gradle 7.5及以上版本
• android/build.gradle与android/app/build.gradle：确认compileSdkVersion和targetSdkVersion设置为33或更高版本

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