Flutter项目中如何获取直接依赖包及其版本并在Widget界面展示

哈哈，我之前踩过一模一样的坑！直接在运行时读pubspec.lock肯定行不通，因为这个文件是咱们开发环境里的专属文件，当App打包安装到设备后，根本不会被包含到安装包的文件系统里，自然就会报找不到文件的错误啦。给你分享两种实用的解决办法，能轻松拿到直接依赖的包和对应版本，还能在Widget里顺利展示出来：

方法一：预构建生成依赖信息文件（简单易上手） #

这个方法是在开发阶段就把依赖信息提取出来，生成一个可以在App里直接引用的Dart文件，完全避开运行时读文件的问题。

1. 编写依赖提取脚本
   在项目根目录新建一个generate_deps.dart文件，用来解析pubspec.lock并生成包含依赖信息的Dart文件：

import 'dart:io';
import 'package:yaml/yaml.dart';

void main() {
  // 读取开发环境下的pubspec.lock文件
  final lockFileContent = File('pubspec.lock').readAsStringSync();
  final lockYamlMap = loadYaml(lockFileContent) as Map;

  // 筛选出直接主依赖（dependency字段为direct main的包）
  final directDependencies = <String, String>{};
  final packages = lockYamlMap['packages'] as Map;
  packages.forEach((packageName, packageDetails) {
    if (packageDetails['dependency'] == 'direct main') {
      directDependencies[packageName.toString()] = packageDetails['version'] as String;
    }
  });

  // 生成可在App中引用的Dart文件
  final outputFile = File('lib/dependencies.g.dart');
  final fileContent = '''
// 自动生成的依赖信息文件，请勿手动修改
final Map<String, String> appDirectDependencies = $directDependencies;
''';
  outputFile.writeAsStringSync(fileContent);
  print('✅ 依赖信息文件已生成：lib/dependencies.g.dart');
}

2. 安装必要依赖
   要运行这个脚本，需要yaml解析包，在pubspec.yaml的dev_dependencies中添加：

yaml: ^3.1.2

然后在终端执行dart pub get安装依赖。

3. 生成依赖文件
   在终端运行dart generate_deps.dart，运行成功后，lib目录下会生成dependencies.g.dart文件，里面已经整理好直接依赖包和对应版本的Map了。

4. 在Widget中展示依赖信息
   现在可以直接在你的Widget里导入这个生成的文件，用任意组件展示，比如用ListView：

import 'package:flutter/material.dart';
import 'dependencies.g.dart';

class DependenciesDisplayScreen extends StatelessWidget {
  const DependenciesDisplayScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('项目直接依赖'),
      ),
      body: ListView.builder(
        padding: const EdgeInsets.all(16),
        itemCount: appDirectDependencies.length,
        itemBuilder: (context, index) {
          final packageName = appDirectDependencies.keys.elementAt(index);
          final version = appDirectDependencies[packageName];
          return Card(
            margin: const EdgeInsets.only(bottom: 12),
            child: Padding(
              padding: const EdgeInsets.all(16),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  Text(
                    packageName,
                    style: const TextStyle(
                      fontSize: 16,
                      fontWeight: FontWeight.bold,
                    ),
                  ),
                  const SizedBox(height: 4),
                  Text('版本：$version'),
                ],
              ),
            ),
          );
        },
      ),
    );
  }
}

方法二：用build_runner自动生成（适合自动化场景） #

如果你希望每次执行pub get后自动更新依赖文件，不想手动跑脚本，可以用build_runner实现自动化生成：

• 先添加build_runner到dev_dependencies：build_runner: ^2.4.6
• 编写一个自定义的Builder类，在构建阶段自动解析pubspec.lock并生成依赖文件
• 运行dart run build_runner build手动触发生成，或者用dart run build_runner watch监听文件变化自动更新

这个方式适合团队协作或者需要频繁更新依赖的项目，不过实现起来比第一种方法稍复杂一些。

关键注意点 #

• 一定要区分直接依赖和间接依赖：pubspec.lock里dependency字段为direct main的才是你在pubspec.yaml的dependencies里直接声明的包，transitive是间接依赖的包，别搞混了。
• 生成的dependencies.g.dart文件可以加入版本控制，也可以每次构建时重新生成，根据团队需求决定即可。

内容来源于stack exchange