未安装Flutter运行Dart文件报Failed to start Dart CLI isolate错误咨询
报错产生原因
这个报错本质是执行dart命令时,运行时找不到DartDev工具对应的核心快照/内核文件,和设备是否安装Flutter无直接关联,常见触发场景:
- 安装的Dart SDK本身不完整:安装包下载损坏、解压/安装过程中被安全软件误删了
bin/snapshots目录下的dartdev.dart.snapshot等核心资源文件。 - 环境变量配置错误:系统PATH里优先级更高的路径下存在残缺的Dart运行时(比如之前卸载Flutter/Dart没清理干净的残留文件、其他开发工具捆绑的不完整Dart组件),导致敲
dart命令时调用的不是完整可用的SDK程序。 - 权限不足:当前系统账号没有Dart SDK安装目录的读取、执行权限,CLI启动时无法加载同目录下的依赖资源。
- 错误使用单文件运行:单独拷贝了
dart.exe/dart可执行文件到系统目录使用,没有带上SDK配套的lib、snapshots等资源文件夹,必然触发该错误。
排查与修复步骤
按顺序操作即可:
- 确认当前生效的dart路径
打开命令行,Windows执行where dart,macOS/Linux执行which dart,查看输出的可执行文件路径。如果路径指向陌生的残留目录、或者未完整安装的Flutter目录下的dart程序,先把对应无效路径从系统PATH变量中删除,再将自行安装的完整Dart SDK的bin目录添加到PATH的最靠前位置,避免被其他无效路径抢占优先级。 - 校验SDK完整性
进入上一步查到的dart可执行文件所在目录,打开同级的snapshots文件夹,检查是否存在dartdev.dart.snapshot文件。如果文件缺失,直接重新部署SDK:- 彻底删除当前残缺的Dart SDK目录,清理掉PATH里对应的无效配置
- 重新下载对应系统架构的稳定版Dart SDK,安装/解压时暂时关闭安全类软件,避免核心文件被误拦截删除
- 配置完环境变量后新开一个命令行窗口,执行
dart --version,如果能正常输出版本号信息,说明基础环境已经修复,可以正常运行Dart文件。
- 修复目录权限
如果确认snapshot文件存在还是报错,Windows系统右键点击Dart SDK根目录,打开「属性-安全」选项,给当前登录用户授予读取、执行、列出文件夹内容的权限;macOS/Linux系统执行sudo chmod -R 755 你的Dart SDK根目录绝对路径,给整个SDK目录加可读可执行权限即可。
注意:不要尝试单独拷贝dart可执行文件到系统目录使用,Dart CLI运行必须依赖同目录下配套的snapshots、lib等资源,单文件无法独立启动。
内容的提问来源于stack exchange,提问作者Andka
相关产品推荐
相关产品推荐

