全局安装的Dart CLI包中dotenv无法加载.env文件求助

当Dart CLI包被全局激活后，默认的DotEnv()..load()会在当前工作目录查找.env文件，而全局包的代码存放在pub-cache中，不会包含项目本地的.env文件，因此需要通过以下方式解决：

方案1：指定.env文件的绝对路径 #

允许用户通过命令行参数传入自定义.env文件的路径，或者预设一个固定的绝对路径（比如用户主目录下的配置文件）。

示例代码：

import 'package:dotenv/dotenv.dart' show DotEnv;
import 'dart:io';

void main(List<String> args) {
  String envPath = '/默认路径，比如~/my_cli_config/.env';
  
  // 解析命令行参数，支持用户传入自定义路径
  for (var arg in args) {
    if (arg.startsWith('--env=')) {
      envPath = arg.split('=').last;
      break;
    }
  }

  final envFile = File(envPath);
  if (!envFile.existsSync()) {
    print('错误：未找到.env文件，请检查路径：$envPath');
    exit(1);
  }

  final env = DotEnv()..load([envPath]);
  // 使用环境变量
  print('加载的变量：${env['API_KEY']}');
}

使用方式：

• 预设路径：用户手动将.env文件放到预设的绝对路径即可
• 自定义路径：执行命令时传入参数 my_cli_command --env=/home/user/custom.env

方案2：直接通过shell设置环境变量 #

不需要依赖.env文件，直接在执行命令时临时设置，或者写入shell配置文件永久生效：

• 临时生效：API_KEY=abc123 my_cli_command
• 永久生效（bash/zsh）：在~/.bashrc或~/.zshrc中添加 export API_KEY=abc123，执行source ~/.bashrc使配置生效

这种方式不需要修改代码，适合简单的环境变量配置。

方案3：将默认.env打包进全局包（仅适用于固定默认配置） #

如果你的包需要提供默认的环境变量配置，可以修改pubspec.yaml将.env文件包含到发布包中：

# pubspec.yaml
files:
  - .env

执行dart pub publish时，.env会被打包到全局包中。但这种方式的.env是固定的，用户无法自定义，仅适合提供默认值的场景。

方案4：自动检测用户主目录下的配置文件 #

让程序默认去用户主目录的指定文件夹查找.env文件，无需用户手动指定路径：

示例代码：

import 'package:dotenv/dotenv.dart' show DotEnv;
import 'package:path/path.dart' as path;
import 'dart:io';

void main() {
  // 获取用户主目录
  final homeDir = Platform.environment['HOME'];
  if (homeDir == null) {
    print('无法获取用户主目录');
    exit(1);
  }

  // 拼接配置文件路径，比如 ~/.my_cli/.env
  final envPath = path.join(homeDir, '.my_cli', '.env');
  final envFile = File(envPath);

  final env = DotEnv();
  if (envFile.existsSync()) {
    env.load([envPath]);
    print('已加载配置文件：$envPath');
  } else {
    // 提示用户创建配置文件
    print('请创建配置文件：$envPath');
    print('示例内容：\nAPI_KEY=your_key_here');
  }

  // 使用环境变量
  final apiKey = env['API_KEY'];
  if (apiKey == null) {
    print('未配置API_KEY，请检查.env文件');
  }
}

用户只需要在自己的主目录下创建.my_cli文件夹和对应的.env文件即可，无需关心全局包的安装位置。

内容的提问来源于stack exchange，提问作者anonymous-dev