You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VSCode运行Flutter文件报错:dart:ui库不可用

解决VSCode中Flutter项目dart:ui不可用及热重载失效问题

以下是针对该问题的排查和解决步骤:

  • 检查并修复VSCode运行配置
    打开「运行和调试」面板,点击「创建launch.json文件」,选择「Flutter」模板生成配置。确保配置内容类似:

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

    若已有配置,检查type是否为dart,program是否指向项目主入口文件(通常是lib/main.dart),避免误选纯Dart运行模式。

  • 更新/回退Dart/Flutter插件
    打开VSCode扩展面板,找到「Dart」和「Flutter」插件:

    • 先尝试更新到最新稳定版,重启VSCode后测试
    • 若更新后问题依旧,点击插件右侧齿轮图标,选择「安装另一个版本」,挑选最近的稳定旧版本(比如前2-3个版本)
  • 确认Flutter SDK路径配置
    打开VSCode设置(Ctrl+, / Cmd+,),搜索「Flutter SDK Path」,确保路径指向你的Flutter安装根目录(例如/Users/yourname/flutter或C:\flutter)。配置完成后重启VSCode,执行flutter doctor确认环境正常。

  • 清理项目缓存与VSCode状态

    1. 手动删除项目根目录下的.dart_tool文件夹,再执行flutter pub get
    2. 按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac),输入「Developer: Reload Window」重载VSCode窗口
    3. 若仍无效,关闭VSCode后删除项目根目录的.vscode文件夹(备份重要配置后操作),重新打开项目
  • 检查终端环境变量一致性
    在VSCode集成终端中执行flutter doctor,查看是否有环境异常提示。如果和系统终端执行结果不一致,说明VSCode终端PATH配置有问题:

    • 打开VSCode设置,搜索「Terminal › Integrated › Shell: Linux/Windows/macOS」,确保使用系统默认shell
    • 或者手动在终端添加Flutter路径:export PATH="$PATH:/your/flutter/path/bin"(Linux/Mac)或set PATH=%PATH%;C:\your\flutter\path\bin(Windows)
  • 移除项目自定义Dart SDK配置
    打开项目根目录的.vscode/settings.json,如果存在"dart.sdkPath"字段,直接删除该配置项,让VSCode自动使用Flutter SDK自带的Dart环境(Flutter内置适配的Dart版本,无需单独配置)

内容的提问来源于stack exchange,提问作者kivancksr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 06:30:37