Flutter项目运行报错：Dart库'dart:ui'当前平台不可用

成因分析 #

• 项目运行方式错误：Android Studio误将Flutter项目识别为普通Dart项目，未调用Flutter专属编译工具链。dart:ui是Flutter核心库，纯Dart运行环境无法识别该库。
• 项目级SDK路径冲突：全局环境变量配置正确，但项目本地配置文件（如local.properties、.idea目录下的配置）指定了错误的Flutter SDK路径，导致package:flutter导入时路径解析异常。
• 缓存残留损坏：Flutter的pub缓存、Android Studio的Gradle缓存或Dart分析缓存出现损坏，导致依赖包的路径映射逻辑出错。
• 多模块依赖冲突：项目中包含纯Dart模块，且该模块直接/间接依赖了package:flutter，但纯Dart模块无法访问dart:ui，引发全局报错。

解决办法 #

1. 修正项目运行配置 #

• 打开Android Studio的运行配置面板（Run > Edit Configurations），删除所有Dart类型的错误配置，添加Flutter类型配置，指定项目根目录下的main.dart作为入口文件。
• 右键点击main.dart文件，选择Run 'main.dart'，确保以Flutter运行方式启动项目。

2. 统一项目与全局SDK路径 #

• 打开项目android/local.properties文件，确认flutter.sdk的路径与全局环境变量中的Flutter SDK路径完全一致，示例：

  flutter.sdk=/Users/yourname/flutter
  

• 删除项目根目录下的.idea文件夹，重启Android Studio，让IDE重新生成项目配置文件。

3. 清理各类缓存 #

• 执行Flutter缓存清理命令：

  flutter clean
  flutter pub get
  flutter pub cache clean
  

• 清理Android Studio缓存：点击File > Invalidate Caches... > Invalidate and Restart，彻底清除IDE的分析缓存与运行缓存。

4. 修复多模块依赖问题 #

• 若项目包含纯Dart模块，检查其pubspec.yaml，确保未直接依赖package:flutter。如需共享代码，将共享部分拆分为Flutter兼容模块（仅在Flutter环境中调用），或让纯Dart模块仅依赖无Flutter依赖的代码。
• 确保运行时仅启动Flutter模块，避免单独运行纯Dart模块。

5. 验证Flutter环境完整性 #

• 执行flutter doctor命令，检查所有环境依赖状态，修复命令输出中提示的所有问题。
• 若flutter doctor显示正常，执行flutter run -v查看详细运行日志，定位具体路径错误位置，手动修正对应配置。

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