Flutter ENVied包Build Runner报错，无法生成env.g.dart文件

问题回顾 #

操作流程中遇到两个核心错误：

1. 首次执行dart run build_runner build报错：Envied requires types to be explicitly declared. 'apiKey' does not declare a type.
2. 显式声明类型后再次执行，报错：Environment variable not found for field 'apiKey'，且未生成env.g.dart文件

分步解决方案 #

1. 修复类型声明问题 #

调整env.dart的代码写法，确保字段类型与生成代码的类型匹配：

import 'package:envied/envied.dart';

part 'env.g.dart';

@Envied(path: '.env')
abstract class Env {
  @EnviedField(varName: 'TEST_KEY')
  static const String apiKey = _Env.apiKey;
}

注意：将final改为const，因为ENVied生成的代码中字段为const类型，保持一致可避免隐性类型错误。

2. 解决环境变量未找到的问题 #

逐一排查以下可能原因：

• 文件位置错误：确保.env文件放在项目根目录（与pubspec.yaml同级），而非lib文件夹内。
• 格式错误：.env文件需严格遵循KEY=VALUE格式，无空格、多余引号，示例：

  TEST_KEY=your_real_api_key
  

• 名称不匹配：确认@EnviedField(varName: 'TEST_KEY')中的键名与.env内的键名完全一致（大小写敏感）。
• 文件被忽略：检查.gitignore，若存在.env忽略规则，确认文件实际已创建且未被隐藏。

3. 重新执行构建命令 #

先清理构建缓存，再执行构建：

dart run build_runner clean
dart run build_runner build

额外注意事项 #

• 执行flutter pub get更新依赖，确保各包版本兼容。
• 始终将.env加入.gitignore，避免敏感信息泄露。

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