如何在GitHub Actions中为Flutter应用注入.env环境变量（不存仓库）

下面提供三种无需硬编码敏感信息的解决方案，按需选择：

方案一：用GitHub Secrets动态生成.env文件 #

这是最贴合你现有代码的方案，不用改业务逻辑，直接在流水线里生成缺失的.env文件：

• 第一步：打开GitHub仓库的「Settings」→「Secrets and variables」→「Actions」，把BACKEND_URL、API_KEY这些敏感变量逐个添加为仓库 Secrets。
• 第二步：在你的GitHub Actions工作流文件（比如.github/workflows/build.yml）里，在flutter pub get或者fastlane构建步骤之前，加一段生成.env的命令：

- name: 生成.env文件
  run: |
    echo "BACKEND_URL=${{ secrets.BACKEND_URL }}" >> .env
    echo "API_KEY=${{ secrets.API_KEY }}" >> .env

• 第三步：确保这个生成步骤在依赖安装和构建之前执行，流水线就能拿到正常的.env文件了。

方案二：跳过.env，直接用Dart定义传递变量 #

如果可以接受修改代码获取变量的方式，这个方案更简洁安全，彻底摆脱.env文件的依赖：

• 第一步：同样在GitHub Secrets里配置好所有敏感变量。
• 第二步：修改工作流中调用fastlane的步骤，把环境变量传进去：

- name: 执行Fastlane构建
  env:
    BACKEND_URL: ${{ secrets.BACKEND_URL }}
    API_KEY: ${{ secrets.API_KEY }}
  run: bundle exec fastlane release

• 第三步：修改Fastfile里的构建逻辑，用--dart-define把变量传给Flutter：

lane :release do
  flutter_build(
    release: true,
    dart_define: {
      BACKEND_URL: ENV['BACKEND_URL'],
      API_KEY: ENV['API_KEY']
    }
  )
  # 这里保留你原来的Play Store上传步骤
end

• 第四步：在Flutter代码里直接通过String.fromEnvironment获取变量，比如：

const String backendUrl = String.fromEnvironment('BACKEND_URL');
const String apiKey = String.fromEnvironment('API_KEY');

这样就不用再依赖flutter_dotenv了，也避免了.env文件的各种问题。

方案三：用模板文件生成.env（适合多环境场景） #

如果需要维护多环境的变量结构，同时保留flutter_dotenv的使用，可以用模板文件生成：

• 第一步：在仓库里提交一个.env.template文件，内容只写变量名占位符：

BACKEND_URL=
API_KEY=

• 第二步：在工作流里基于模板生成真实的.env文件：

- name: 从模板生成.env
  run: |
    cp .env.template .env
    sed -i "s/BACKEND_URL=/BACKEND_URL=${{ secrets.BACKEND_URL }}/" .env
    sed -i "s/API_KEY=/API_KEY=${{ secrets.API_KEY }}/" .env

• 第三步：确保.env仍然在.gitignore里，只提交模板文件到仓库。

方案对比 #

• 方案一：零代码改动，完全兼容现有逻辑，适合快速解决问题
• 方案二：更安全，减少依赖，适合重构优化场景
• 方案三：保留多环境模板结构，适合需要管理多个环境变量配置的项目

内容的提问来源于stack exchange，提问作者Marcos Echagüe