如何在GitHub Actions中获取环境变量列表并自动生成.env文件？

核心方案：利用GitHub Actions实现自动化 #

GitHub Actions可以直接访问仓库环境专属的变量和密钥，是最贴合GitHub生态的自动化实现方式，无需额外第三方工具。

具体实现步骤 #

1. 创建GitHub Workflow配置文件
   在仓库根目录下创建.github/workflows/generate-env.yml文件，示例配置如下：

name: Generate & Sync .env
on:
  push:
    branches: [ main ]  # 触发条件：推送代码到main分支时执行
  workflow_dispatch:    # 支持手动触发执行

jobs:
  build-env:
    runs-on: ubuntu-latest
    environment: production  # 指定要读取的GitHub环境名称（需提前在仓库Settings中创建）
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Generate .env file
        run: |
          # 按格式写入环境变量和密钥，变量名对应你在GitHub环境中设置的名称
          echo "API_BASE_URL=${{ vars.API_BASE_URL }}" >> .env
          echo "DB_PORT=${{ vars.DB_PORT }}" >> .env
          echo "DB_USER=${{ secrets.DB_USER }}" >> .env
          echo "DB_PASS=${{ secrets.DB_PASS }}" >> .env

      - name: Sync .env to remote server  # 可选：如需将文件传到远程部署环境
        uses: appleboy/scp-action@v0.1.7
        with:
          host: ${{ vars.REMOTE_HOST }}
          username: ${{ vars.REMOTE_USER }}
          key: ${{ secrets.REMOTE_SSH_KEY }}
          source: ".env"
          target: "/path/to/your/app/directory"

2. 批量生成.env（针对大量变量场景）
   如果环境变量数量较多，不想手动逐个写入，可借助GitHub CLI批量导出公开变量：

- name: Install GitHub CLI
        run: sudo apt-get install gh -y

      - name: Authenticate GitHub CLI
        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token

      - name: Generate .env in bulk
        run: |
          # 批量导出环境变量（vars部分）
          gh repo env list --env production --json name,value --jq '.[] | "\(.name)=\(.value)"' >> .env
          # 敏感密钥仍需手动指定（GitHub CLI无法直接读取secrets值）
          echo "DB_PASS=${{ secrets.DB_PASS }}" >> .env

其他场景：远程服务器定时更新.env #

如果需要在自有远程服务器上定期同步.env文件，可设置cron任务配合GitHub CLI：

1. 在服务器上安装GitHub CLI并完成授权（gh auth login）
2. 创建脚本update-env.sh：

#!/bin/bash
REPO="your-username/your-repo"
ENV="production"
TARGET_PATH="/path/to/your/app/.env"

# 清空旧文件
> $TARGET_PATH

# 批量导出公开环境变量
gh repo env list --repo $REPO --env $ENV --json name,value --jq '.[] | "\(.name)=\(.value)"' >> $TARGET_PATH
# 添加敏感密钥（建议通过服务器本地安全存储方式传入，比如本地环境变量）
echo "DB_PASS=$SERVER_DB_PASS" >> $TARGET_PATH

3. 设置cron定时任务（每天凌晨自动更新）：

0 0 * * * /path/to/update-env.sh

注意事项 #

• 确保GitHub环境已正确创建，Workflow中指定的environment名称需与实际一致
• GITHUB_TOKEN默认具备读取环境变量的权限，无需额外配置
• 敏感密钥（secrets）会被GitHub Actions自动屏蔽，不要在日志中主动输出
• 远程部署时，SSH密钥等敏感信息必须通过GitHub Secrets存储，禁止明文写在配置中

内容的提问来源于stack exchange，提问作者Matthew T