Flutter Android模板项目运行报错：系统找不到指定路径求解决

架构老林

2026-7-8

Flutter项目运行时提示找不到已存在Dart文件的解决办法

问题场景

运行mathebuddy项目执行assembleDebug任务时，出现如下错误：

Running Gradle task 'assembleDebug'...
lib/color.dart:8:8: Error: Error when reading 'lib/mbcl/src/level_item.dart': The system cannot find the path specified.
import 'package:mathebuddy/mbcl/src/level_item.dart';
^

已确认目标文件存在于指定目录，项目存储在D盘，Android Studio安装在C盘，怀疑盘符配置可能引发问题。

排查与解决方案

检查pubspec.yaml依赖配置
确认pubspec.yaml中是否正确声明了mathebuddy包的路径。如果是本地依赖，需配置正确的相对路径：
```
dependencies:
  mathebuddy:
    path: ./相对路径/到mathebuddy包
```
执行flutter pub get更新依赖，确保依赖链加载正常。
验证路径大小写一致性
Windows系统文件路径不区分大小写，但Dart的import语句严格区分。检查import中的路径和实际文件路径的大小写是否完全匹配，比如level_item.dart和Level_Item.dart会被视为不同文件。
清理项目与IDE缓存
1. 执行flutter clean清理构建缓存
2. 重启Android Studio，通过File → Invalidate Caches...清除IDE缓存（勾选Clear file system cache and local history后点击Invalidate and Restart）
3. 重新执行flutter pub get和flutter run
排查盘符权限问题
右键项目文件夹，进入属性 → 安全，确认当前用户拥有该文件夹的读写/完全控制权限。也可以尝试将项目复制到C盘（与Android Studio同盘符）运行，验证是否是盘符路径解析或权限导致的问题。
调整import路径写法
如果是项目内部文件，可尝试改用相对路径导入替代package路径，比如：
```
import './mbcl/src/level_item.dart';
```
同时确认pubspec.yaml中的name字段是否为mathebuddy，package路径的前缀需与该字段一致。