如何自动将GitHub变量与Secrets写入.env.local？含报错排查

方案一：自动遍历环境变量生成文件（无需手动维护） #

GitHub Actions会自动将仓库级的Variables和Secrets注入为环境变量，因此可以直接遍历筛选目标变量写入文件，无需逐行手动添加：

- name: 📝 自动生成.env.local文件
  run: |
    touch .env.local
    # 筛选并写入指定前缀的变量（可根据需求调整正则规则）
    for var in $(printenv | grep -E "^DB_|^FILESTORAGE_|^WEB_"); do
      echo "$var" >> .env.local
    done

如果需要保留所有非GitHub系统变量，可调整筛选规则：

- name: 📝 自动生成.env.local文件
  run: |
    touch .env.local
    # 排除GitHub自带的系统环境变量，写入其余变量
    for var in $(printenv | grep -v "^GITHUB_" | grep -v "^ACTIONS_" | grep -v "^RUNNER_"); do
      echo "$var" >> .env.local
    done

方案二：修复jq解析报错问题 #

你遇到的parse error: Invalid numeric literal错误，是因为未正确处理变量值中的特殊字符（如引号、换行）导致JSON结构损坏。以下是修正后的jq处理方案：

- name: 🛠️ 用jq生成.env.local文件
  run: |
    touch .env.local
    # 将环境变量转为合法JSON结构
    printenv | grep -E "^DB_|^FILESTORAGE_|^WEB_" | jq -R 'split("=") | {key: .[0], value: .[1]}' | jq -s '.' > temp_env.json
    # 从JSON提取键值对写入文件
    jq -r '.[] | "\(.key)=\(.value)"' temp_env.json >> .env.local
    rm temp_env.json

核心是用jq -R按行读取环境变量，再转为标准JSON对象，避免特殊字符破坏解析。

关键注意事项 #

• 仓库级Variables/Secrets会自动注入Workflow环境，环境级变量需在Workflow中指定environment字段调用。
• 若有敏感变量无需写入文件，可在grep规则中添加排除项（如grep -v "^SENSITIVE_VAR_"）。

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