如何修复GitHub Actions构建Windows版Go编译器的失败问题

我是Go语言新手，希望通过GitHub Actions从源码构建适用于Windows的Go编译器，但编写的多份GitHub Actions配置文件均执行失败。失败的主要原因多为Git安装失败，或无法克隆Go源码仓库。我参考了WindowsBuild文档编写配置，请问该如何修复这些YAML配置文件？

原配置的问题分析 #

尝试1的核心问题 #

• Shell语法不兼容：Windows runner默认使用PowerShell，但步骤中使用了Bash的if [ -f ]语法，直接执行会报错
• MinGW安装逻辑缺失：未提前下载mingw-get-inst.exe就直接调用，导致文件不存在
• Matrix配置位置错误：strategy应与steps同级，放在jobs.build下，原配置将其放在steps内完全无效
• 构建步骤未实现：64位构建仅保留注释，无实际执行逻辑

尝试2的核心问题 #

• 冗余Git安装：windows-latest runner自带Git，用choco重复安装会导致版本冲突
• 版本占位符未替换：git checkout goX.Y.Z中的X.Y.Z未替换为实际版本号，导致checkout失败
• 环境变量设置无效：修改profile.bat不会在当前Workflow会话中生效，后续步骤无法直接调用go命令
• Release参数缺失：actions/create-release@v1需要tag_name和release_name等必填参数，原配置完全缺失

尝试3的核心问题 #

• 交叉编译依赖缺失：Ubuntu上交叉编译Windows程序需要安装mingw-w64工具链，原配置未添加
• 版本占位符未替换：同样存在goX.Y.Z未替换的问题
• 验证步骤无效：Linux系统无法直接运行Windows二进制文件，go version步骤必然失败
• 文件路径错误：交叉编译生成的Windows二进制位于/usr/local/go/bin/windows_amd64/，而非根bin目录

修复后的配置方案 #

方案1：Windows Runner本地构建 #

直接在Windows环境下构建，无需交叉编译，适配32/64位架构：

name: Build Go Compiler for Windows (Native)

on:
  push:
    branches:
      - master

jobs:
  build:
    runs-on: windows-latest
    strategy:
      matrix:
        goarch: ['386', 'amd64']

    steps:
    - name: 拉取Go源码
      uses: actions/checkout@v4
      with:
        repository: golang/go
        ref: go1.22.0 # 替换为你需要的Go版本号，如go1.21.7
        path: go-source

    - name: 设置构建环境变量
      run: |
        echo "GOARCH=${{ matrix.goarch }}" >> $env:GITHUB_ENV
        $srcPath = Join-Path -Path $env:GITHUB_WORKSPACE -ChildPath "go-source/src"
        echo "$srcPath" >> $env:GITHUB_PATH

    - name: 构建Go编译器
      run: |
        cd go-source/src
        .\make.bat --no-clean

    - name: 验证构建结果
      run: |
        $goBinPath = Join-Path -Path $env:GITHUB_WORKSPACE -ChildPath "go-source/bin/go.exe"
        & $goBinPath version

    - name: 准备构建产物
      run: |
        $artifactDir = Join-Path -Path $env:GITHUB_WORKSPACE -ChildPath "go-windows-${{ matrix.goarch }}"
        New-Item -ItemType Directory -Path $artifactDir -Force | Out-Null
        Copy-Item -Path "go-source/bin/*.exe" -Destination $artifactDir

    - name: 上传构建产物
      uses: actions/upload-artifact@v4
      with:
        name: go-windows-${{ matrix.goarch }}
        path: go-windows-${{ matrix.goarch }}

方案2：Ubuntu Runner交叉编译 #

在Linux环境下交叉编译Windows版本，速度更快：

name: Build Go Compiler for Windows (Cross-Compile)

on:
  push:
    branches:
      - master

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        goarch: ['386', 'amd64']

    steps:
    - name: 安装交叉编译依赖
      run: |
        sudo apt-get update
        sudo apt-get install -y mingw-w64

    - name: 拉取Go源码
      uses: actions/checkout@v4
      with:
        repository: golang/go
        ref: go1.22.0 # 替换为你需要的Go版本号
        path: go-source

    - name: 交叉编译Windows版Go编译器
      run: |
        cd go-source/src
        GOOS=windows GOARCH=${{ matrix.goarch }} ./make.bash --no-clean

    - name: 验证二进制类型
      run: |
        file go-source/bin/windows_${{ matrix.goarch }}/go.exe

    - name: 准备构建产物
      run: |
        artifactDir="go-windows-${{ matrix.goarch }}"
        mkdir -p "$artifactDir"
        cp go-source/bin/windows_${{ matrix.goarch }}/*.exe "$artifactDir/"

    - name: 上传构建产物
      uses: actions/upload-artifact@v4
      with:
        name: go-windows-${{ matrix.goarch }}
        path: go-windows-${{ matrix.goarch }}

关键修复说明 #

• 直接拉取源码：用actions/checkout官方拉取golang/go仓库，避免手动克隆的网络权限问题
• 明确版本号：将ref替换为实际的Go版本标签（如go1.22.0），避免占位符错误
• Shell适配：Windows步骤用PowerShell语法，Ubuntu用Bash，避免语法冲突
• 依赖前置处理：Ubuntu交叉编译时提前安装mingw-w64，Windows利用runner自带环境
• 路径正确指向：交叉编译的Windows二进制位于bin/windows_${GOARCH}/目录，而非根bin目录
• 环境变量正确传递：通过GITHUB_ENV和GITHUB_PATH设置环境，确保步骤间生效

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