运行Flutter默认模板应用时报错Error: Not found: 'dart:ui'如何解决

你遇到的Error: Not found: 'dart:ui'报错核心原因是Flutter专属库未被正确识别，dart:ui是Flutter SDK内置的图形渲染基础库，普通Dart SDK不包含该库，纯Dart控制台项目不会调用这个库所以可以正常运行，Flutter项目依赖该库，运行环境不匹配时就会抛出该错误。

常见触发原因 #

• 使用普通Dart运行命令dart run执行Flutter项目
• VS Code运行配置错误，选择了Dart命令行模式启动Flutter项目
• Flutter SDK路径未被VS Code正确识别，或本地Flutter环境配置存在问题
• 项目依赖缓存损坏

对应解决步骤 #

1. 确认运行命令
   不要使用dart run启动Flutter项目，在项目根目录打开终端，执行以下命令运行：

# 先清理缓存并拉取依赖
flutter clean
flutter pub get
# 启动项目，执行前请确保已连接模拟器/物理设备，或选择桌面/浏览器作为运行目标
flutter run

2. 修正VS Code运行配置

• 确保已经安装VS Code官方的Flutter和Dart插件
• 打开左侧「运行和调试」面板，点击创建launch.json文件，选择Flutter作为配置类型，生成的配置示例如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "flutter_demo",
            "request": "launch",
            "type": "dart",
            "program": "lib/main.dart"
        }
    ]
}

• 运行时选择上方的Flutter配置启动，不要选择Dart命令行配置。

3. 检查Flutter环境配置
   在终端执行flutter doctor命令，检查输出的所有项是否都为正常状态，若存在报错按照提示修复即可，同时确认本地没有同时配置多个Dart SDK路径导致冲突。

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