Flutter本地托管包已安装成功但无法导入的问题求助

你在本地托管第三方地图SDK包后，执行flutter pub get显示安装成功，但无法在Dart文件中通过import 'package:custom_sdk/any_file.dart';导入，且发现.pub-cache/hosted目录下存在pub.dev和localhost两个条目。先明确：.pub-cache/hosted下的多条目本身不是问题，Flutter会根据pubspec配置的host地址匹配对应目录的包，导入失败的核心原因通常是包结构、托管服务或配置的问题，以下是具体排查和解决步骤：

• 检查本地托管包的结构规范
  确认你托管的custom_sdk完全符合Dart包的要求：

  • 包根目录必须有pubspec.yaml，且其中的name字段必须和你项目pubspec里配置的custom_sdk完全一致（大小写、拼写都不能错）
  • 包内的核心代码必须放在lib目录下，比如你要导入的any_file.dart必须位于custom_sdk/lib/any_file.dart，否则导入路径不匹配
  • 检查包的pubspec.yaml是否声明了正确的environment字段，比如：

    environment:
      sdk: '>=3.0.0 <4.0.0'
    

    确保和你的Flutter项目的Dart版本兼容

• 验证本地托管服务的可用性

  • 打开浏览器访问http://localhost:8080/custom_sdk-4.16.5.tar.gz，确认能正常下载这个包归档文件
  • 下载后解压，检查解压后的目录结构是否符合上述Dart包规范，避免归档文件本身损坏或结构错误

• 清理缓存并重新安装

  • 删除项目根目录下的.dart_tool文件夹，清除项目本地缓存
  • 找到.pub-cache/hosted/localhost:8080/custom_sdk目录并删除，彻底清理本地托管的包缓存
  • 重新执行flutter pub get，观察控制台输出，确认包被正确下载（如果有错误日志，根据日志定位问题）

• 核对导入语句的正确性

  • 确认导入的文件名、路径和包内的实际文件完全一致，注意Linux/macOS环境下路径大小写敏感
  • 如果文件在lib的子目录中，比如lib/map/utils.dart，导入语句应该写为import 'package:custom_sdk/map/utils.dart';

• 更简单的替代方案：直接引用本地路径
  如果本地HTTP托管的方式麻烦，你可以直接在项目的pubspec.yaml中引用本地文件系统的包路径，这样更直观且不易出错：

  custom_sdk:
    path: /Users/xxx/Documents/custom_sdk  # 替换为你的本地包实际路径
  

  配置后执行flutter pub get，即可正常导入使用

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