如何跨平台以顶层.env为唯一可信源配置多目录构建脚本？

我正在为FreeCAD开发一套开发场景的构建系统，目录结构如下：

(Main)
  (Linux)
    (Ubuntu)
      ubuntu.sh
      ubuntu.Dockerfile
    (Fedora)
      fedora.sh
      fedora.Dockerfile
  (Windows)
  (Mac)
  .env

核心需求：

• 顶层.env作为唯一可信配置源，所有子目录的脚本、Dockerfile等无需硬编码其绝对/相对路径
• 避免在子目录放置独立.env文件，除非能自动同步
• 实现跨平台兼容（Linux/Windows/macOS）

以下是几种实用解决方案：

方案1：Git钩子+跨平台符号链接自动维护本地.env #

利用符号链接让子目录的./.env指向顶层配置，通过Git钩子自动同步链接：

• 实现步骤：
  1. 顶层创建脚本setup-env-links.sh（兼容Linux/macOS，Windows可通过Git Bash/WSL执行）：

     #!/bin/bash
     TOP_DIR=$(git rev-parse --show-toplevel)
     # 遍历所有需要.env的子目录
     find "$TOP_DIR" -type d \( -name "Ubuntu" -o -name "Fedora" -o -name "Windows" -o -name "Mac" \) | while read -r dir; do
       rm -f "$dir/.env"
       ln -s "$TOP_DIR/.env" "$dir/.env"
     done
     

     配套PowerShell版本setup-env-links.ps1供Windows原生环境使用：

     $TOP_DIR = git rev-parse --show-toplevel
     Get-ChildItem -Path $TOP_DIR -Directory -Include Ubuntu,Fedora,Windows,Mac -Recurse | ForEach-Object {
       $linkPath = Join-Path $_.FullName ".env"
       if (Test-Path $linkPath) { Remove-Item $linkPath }
       New-Item -ItemType SymbolicLink -Path $linkPath -Target (Join-Path $TOP_DIR ".env") | Out-Null
     }
     

  2. 配置Git钩子：在.git/hooks/post-checkout和.git/hooks/post-merge中添加触发逻辑，确保切换分支/合并后自动更新链接：

     #!/bin/bash
     exec "$(git rev-parse --show-toplevel)/setup-env-links.sh"
     

• 优势：子目录脚本、Dockerfile只需引用./.env，完全无需关心路径；链接自动维护，零手动操作；Git环境下自动触发同步。
• 注意：Windows需开启开发者模式或用管理员权限创建符号链接；macOS/Linux无特殊权限要求。

方案2：跨平台dotenv工具统一加载顶层配置 #

使用dotenv-cli（基于Node.js，跨平台兼容），无需修改子目录文件，通过统一入口加载配置：

• 实现步骤：
  1. 安装工具：npm install -g dotenv-cli
  2. 顶层创建统一入口脚本run，封装所有子脚本调用逻辑：

     #!/bin/bash
     TOP_DIR=$(git rev-parse --show-toplevel)
     case "$1" in
       ubuntu) dotenv -e "$TOP_DIR/.env" -- "$TOP_DIR/Linux/Ubuntu/ubuntu.sh" ;;
       fedora) dotenv -e "$TOP_DIR/.env" -- "$TOP_DIR/Linux/Fedora/fedora.sh" ;;
       *) echo "Usage: $0 [ubuntu|fedora|...]" ;;
     esac
     

  3. Docker构建时直接引用顶层.env：

     docker build --env-file .env -f Linux/Ubuntu/ubuntu.Dockerfile .
     

• 优势：无需维护子目录链接；脚本和Docker构建统一加载配置；跨平台兼容性强。
• 注意：依赖Node.js环境；Docker构建需从顶层目录执行（可封装到入口脚本）。

方案3：Shell函数库封装.env加载逻辑（仅脚本场景） #

针对Shell脚本场景，用函数库自动定位并加载顶层.env：

• 实现步骤：
  1. 顶层创建load-env.sh函数库：

     # load-env.sh
     load_env() {
       # 优先通过Git定位顶层目录
       local TOP_DIR=$(git rev-parse --show-toplevel 2>/dev/null)
       # 非Git环境下向上查找.env
       if [ -z "$TOP_DIR" ]; then
         local DIR=$(pwd)
         while [ ! -f "$DIR/.env" ] && [ "$DIR" != "/" ]; do
           DIR=$(dirname "$DIR")
         done
         TOP_DIR=$DIR
       fi
       # 加载环境变量
       if [ -f "$TOP_DIR/.env" ]; then
         set -a
         source "$TOP_DIR/.env"
         set +a
       else
         echo "Error: .env file not found" >&2
         exit 1
       fi
     }
     

  2. 子脚本（如ubuntu.sh）顶部添加：

     #!/bin/bash
     source "$(git rev-parse --show-toplevel)/load-env.sh"
     load_env
     # 后续脚本逻辑...
     

• 优势：子脚本只需一行引入，无需硬编码路径；兼容Git和非Git环境；轻量无额外依赖。
• 注意：Windows原生PowerShell需单独编写函数库，或用Git Bash执行脚本。

方案选择建议 #

• 若需同时兼容Docker和各类脚本，优先选方案1，最直观且无需修改子目录资源；
• 若不想依赖符号链接，选方案2，通过统一入口管理所有配置加载；
• 仅Shell脚本场景下，方案3是最轻量的选择。

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