如何修复Flutter集中依赖包项目中的导入包Lint警告

问题描述 #

我通过一个本地dependencies包集中管理所有项目依赖（以path方式引入），主项目未直接在pubspec.yaml中声明get这类包，结果触发Lint警告：

"The imported package 'get' isn't a dependency of the importing package."

相关配置示例如下：

依赖管理包pubspec.yaml #

name: dependencies
description: dependencies of projects
version: 0.0.1
publish_to: 'none'

environment:
  sdk: '>=3.0.5 <4.0.0'

dependencies:
  flutter:
    sdk: flutter
  
  get: ^4.6.5
  logger: ^1.1.0
  device_info: ^2.0.0
  get_it: ^7.1.3

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

flutter:

主项目pubspec.yaml #

name: main_project
description: main_project that depends on the package

publish_to: 'none'

version: 1.0.0+1

environment:
  sdk: '>=3.0.5 <4.0.0'

dependencies:
  dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter 

dependency_overrides: 
  dependencies:
    path: packages/common/dependencies

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

flutter:

我需要解决这个警告，同时有疑问：在主项目中添加get: any会拉取pub.dev最新版本吗？还是会使用依赖管理包中的版本？

解决办法 #

方法1：给主项目添加依赖占位符 #

在主项目的dependencies节点中，将需要直接导入的包添加进去，版本写any即可：

dependencies:
  dependencies:
  get: any
  logger: any
  get_it: any
  # 其他需要直接导入的包同理添加
  flutter:
    sdk: flutter
  ...

这种写法不会拉取pub.dev的最新版本。因为依赖管理包已经指定了具体版本，any只是告知Lint工具“该包是当前项目的合法依赖”，实际会使用依赖管理包传递过来的版本。

方法2：禁用特定Lint规则 #

如果不想逐个添加占位符，可以在项目的analysis_options.yaml中关闭触发警告的规则：

linter:
  rules:
    package_dependency_not_declared: false

注意：此方法会全局关闭这类检查，可能错过真正忘记声明依赖的场景。

方法3：通过依赖管理包导出所需包 #

在依赖管理包的lib目录下创建一个导出文件（比如lib/exports.dart），将需要暴露给主项目的包统一导出：

export 'package:get/get.dart';
export 'package:logger/logger.dart';
export 'package:get_it/get_it.dart';
// 其他需要主项目使用的包

之后主项目不要直接导入get等包，而是导入这个导出文件：

import 'package:dependencies/exports.dart';

这样Lint工具会认为你在使用依赖管理包提供的内容，不会触发警告，也更符合集中管理的设计思路。

关于get: any的疑问解答 #

主项目中添加get: any不会拉取pub.dev的最新版本。pub的依赖解析逻辑是优先使用已存在的、更具体的版本约束——依赖管理包已经指定了^4.6.5，所以主项目的any仅作为Lint检查的“通行证”，实际使用的还是依赖管理包中声明的版本。

内容的提问来源于stack exchange，提问作者samuel-lucas