Dart无命名空间致Flutter导入失效，求排查原因

由于Dart没有命名空间机制，导入/导出操作很容易踩这些坑，你可以逐一排查：

• 路径大小写或层级错误
  Dart对路径大小写严格敏感，哪怕系统文件系统不区分（比如Windows），代码里的路径大小写和实际文件不一致就会失败。比如实际文件是UserModel.dart，写成usermodel.dart就会找不到。
  另外相对路径的层级要准确，比如当前文件在lib/pages/，要导入lib/common/constants.dart，得写成../common/constants.dart，层级算错直接导致路径无效。

• pubspec.yaml配置遗漏
  如果目标文件在lib目录以外（比如项目根目录的scripts/或config/），没在pubspec里配置对应的资源或源路径，Dart编译器不会识别这些文件。要是用package:前缀导入本地包，得确保pubspec里的dependencies或dev_dependencies正确配置了本地包路径。

• 目标文件本身有问题
  目标文件不是.dart后缀、存在语法错误（比如括号不匹配、缺少分号），都会导致编译器无法解析该文件，表现出来就是导入失效。先检查目标文件的语法是否正常。

• 间接导出的路径错误
  如果是通过中间文件export后再导入，要确认中间文件的export语句路径正确。比如中间文件exports.dart里写export './widgets/custom_button.dart';，路径写错的话，导入exports.dart也拿不到目标文件的内容。

• IDE索引或缓存问题
  有时候IDE索引未更新、Flutter缓存堆积会导致假的"文件找不到"提示。可以试试：

  • 执行命令：flutter clean清理缓存，再flutter pub get重新拉取依赖
  • 重启IDE，或触发IDE重新索引（比如VS Code按Ctrl+Shift+P选择"Reload Window"）

内容的提问来源于stack exchange，提问作者László Frank