Flutter使用flutter-dotenv时，如何让构建仅复制存在的.env资产？

有几种方案可以实现让Flutter构建流程只复制存在的.env文件，无需依赖空文件：

方案1：使用构建前钩子脚本（推荐） #

通过Flutter的构建钩子，在构建前自动检查.env文件是否存在，仅当文件存在时才复制到资产目录：

1. 在项目根目录创建脚本文件：

   • Linux/macOS 创建 copy_env.sh：

     #!/bin/bash
     # 源.env文件路径，根据你的实际位置调整
     SOURCE_ENV="./.env"
     # 目标资产目录路径，要和pubspec里配置的一致
     DEST_ENV="./assets/.env"
     
     if [ -f "$SOURCE_ENV" ]; then
       echo "检测到.env文件，复制到资产目录..."
       cp "$SOURCE_ENV" "$DEST_ENV"
     else
       echo ".env文件不存在，跳过复制步骤。"
     fi
     

   • Windows 创建 copy_env.bat：

     @echo off
     set SOURCE_ENV=.\.env
     set DEST_ENV=.\assets\.env
     
     if exist "%SOURCE_ENV%" (
       echo 检测到.env文件，复制到资产目录...
       copy "%SOURCE_ENV%" "%DEST_ENV%"
     ) else (
       echo .env文件不存在，跳过复制步骤。
     )
     

2. 给脚本添加执行权限（仅Linux/macOS）：

   chmod +x copy_env.sh
   

3. 修改pubspec.yaml，配置构建前钩子并指定资产路径：

   flutter:
     assets:
       - assets/.env
     scripts:
       pre-build: ./copy_env.sh  # Windows用户换成./copy_env.bat
   

每次构建前，脚本会自动检查并处理.env文件，文件不存在时不会复制，也不会因资产缺失报错。

方案2：调整flutter-dotenv的加载逻辑 #

如果不想修改构建流程，可以在代码里判断.env文件是否存在，动态加载配置：

import 'package:flutter_dotenv/flutter_dotenv.dart';
import 'dart:io';
import 'package:flutter/widgets.dart';

Future<void> initEnv() async {
  try {
    // 检查项目根目录的.env文件是否存在（打包后路径需根据实际情况调整）
    final envFile = File('.env');
    if (await envFile.exists()) {
      await dotenv.load(fileName: '.env');
    } else {
      // 加载预设的默认配置
      dotenv.env['API_BASE_URL'] = 'https://default-api.example.com';
      dotenv.env['DEBUG_MODE'] = 'false';
    }
  } catch (e) {
    // 加载异常时也使用默认配置
    dotenv.env['API_BASE_URL'] = 'https://default-api.example.com';
  }
}

然后在main()函数中先初始化环境配置再启动App：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initEnv();
  runApp(const MyApp());
}

这种方式无需在pubspec里强制配置.env为资产，完全通过代码逻辑处理文件缺失的情况。

内容的提问来源于stack exchange，提问作者Juan Alberto López Cavallotti