本地创建的Dart包导入报错“目标URI不存在”，如何解决？

完全不需要把包发布到pub.dev，用本地路径依赖就能搞定，具体操作如下：

1. 确认本地包结构合规 #

你的复用代码包必须符合Dart包的基本规范：

• 根目录要有pubspec.yaml文件，至少填好name（包名）和version字段
• 所有对外暴露的代码都放在lib/目录下，子目录结构可按需安排

2. 在目标项目的pubspec.yaml中添加本地依赖 #

打开需要导入该包的项目的pubspec.yaml，在dependencies节点下添加本地包的路径配置，有两种写法：

• 相对路径（适合两个项目在同一父目录下的场景）：

  dependencies:
    my_shared_package:
      path: ../my_shared_package
  

  这里的my_shared_package要和本地包pubspec.yaml里的name完全一致，../代表上一级目录，根据实际层级调整。
• 绝对路径（适合本地包在任意位置的场景）：

  dependencies:
    my_shared_package:
      path: /Users/username/projects/my_shared_package
  

3. 加载本地依赖 #

在目标项目的根目录执行命令：

dart pub get

执行完成后，Dart会关联你的本地包，IDE也会自动识别该包的代码。

4. 导入并使用本地包代码 #

在目标项目的Dart文件中，通过包名导入需要的代码：

import 'package:my_shared_package/utils/helper.dart';

关于路径环境变量的说明 #

Dart没有专门用于查找本地包的环境变量，本地包的识别完全依赖pubspec.yaml中的path配置，无需折腾环境变量。

常见报错排查点 #

如果仍出现“The target URI doesnt exist”，可以检查这几点：

• 确认pubspec.yaml里的包名和本地包的name字段完全匹配，大小写也要一致
• 检查路径拼写是否正确，相对路径的层级是否准确
• 本地包的lib/目录下确实存在你要导入的文件
• 执行dart pub get后，重启IDE或者刷新项目依赖（部分IDE需要手动触发刷新）

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