Flutter多平台开发部分包不兼容，如何为web端排除指定依赖？

核心实现方案：Dart条件导入 + 平台差异化实现 #

这是官方推荐的跨平台兼容处理方式，不需要拆分项目，也不需要额外配置构建参数，即可完全隔离web端不需要的不兼容依赖：

• 首先把依赖不兼容包的逻辑抽成抽象接口，分别编写非web端、web端两套实现
  • 非web端实现正常引入path_provider等不兼容web的包，实现对应业务逻辑
  • web端实现完全不引入不兼容包，用web端兼容的能力做替代（比如路径类需求可以用浏览器localStorage、内存路径替代，文件读写需求可以用html包的File API替代）
• 用Dart内置的条件导入语法做统一导出，编译器会根据编译平台自动选择对应的实现文件，web构建时完全不会加载引入了不兼容包的实现文件，自然不会触发兼容报错

示例代码如下：

// 1. 抽象接口文件 storage.dart
abstract class StorageUtil {
  Future<String> getCachePath();
}

// 2. 非web端实现文件 storage_native.dart
import 'package:path_provider/path_provider.dart';

class StorageUtilImpl implements StorageUtil {
  @override
  Future<String> getCachePath() async {
    final cacheDir = await getTemporaryDirectory();
    return cacheDir.path;
  }
}

// 3. web端实现文件 storage_web.dart
class StorageUtilImpl implements StorageUtil {
  @override
  Future<String> getCachePath() async {
    // 这里替换为web端兼容的逻辑即可
    return '/web_temp_cache';
  }
}

// 4. 统一导出入口 storage_export.dart
export 'storage_native.dart' if (dart.library.html) 'storage_web.dart';

• 业务层只需要导入storage_export.dart使用StorageUtilImpl即可，无需关心平台差异
• Dart编译时的tree shaking机制会自动把未使用的依赖包完全排除在web构建产物外，不需要额外配置排除规则

补充说明 #

• 你提到的path_provider官方已经推出了web兼容版本，升级到path_provider: ^2.0.0以上版本即可直接在web端使用，不需要自行实现替代逻辑
• 所有不兼容web的包都可以用上述条件导入的方式隔离，只要确保web端的执行路径中没有任何导入不兼容包的语句，就不会触发编译错误

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