如何在Flutter中引入应用目录外的源文件？

问题原因 #

Flutter的Dart编译环境默认只扫描当前项目lib目录下的文件，直接使用跨项目的相对路径（如../../shared-classes/class1.dart）会因为编译器无法访问项目目录外的文件，导致报错“Target of URI doesn't exist”。

可行解决方案 #

方案1：使用Windows符号链接（软链接） #

通过在项目lib目录下创建指向外部共享目录的软链接，让Flutter将外部目录视为项目内部目录的一部分：

1. 打开PowerShell或CMD，进入你的Flutter项目的lib目录
2. 执行创建软链接的命令：
   • PowerShell：New-Item -ItemType SymbolicLink -Path .\shared-classes -Target "D:\实际路径\shared-classes"
   • CMD：mklink /D shared-classes "D:\实际路径\shared-classes"
3. 完成后，即可像导入内部文件一样使用：

   import '/shared-classes/class1.dart';
   

   或根据当前文件位置使用相对路径导入。

注意：VS Code默认会跟随符号链接，若出现识别问题，可检查设置中files.watcherExclude是否排除了软链接目录。

方案2：简化本地路径依赖（仅需极简pubspec.yaml） #

无需创建完整的Flutter Package，只在共享目录中添加一个基础的pubspec.yaml即可：

1. 在外部shared-classes目录下创建pubspec.yaml，内容示例：

   name: shared_classes
   version: 1.0.0
   environment:
     sdk: '>=3.0.0 <4.0.0' # 匹配你的Flutter SDK版本
   

2. 在需要共享的Flutter项目的pubspec.yaml中添加依赖：

   dependencies:
     flutter:
       sdk: flutter
     shared_classes:
       path: ../../shared-classes/ # 替换为共享目录的实际相对路径
   

3. 执行flutter pub get，之后即可通过package方式导入：

   import 'package:shared_classes/class1.dart';
   

这个方法比完整Package更轻量化，同时能利用Dart的依赖管理机制避免路径问题。

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