在Linux系统上开发Go语言程序时，经常需要生成可以直接在Windows系统运行的二进制可执行文件，这时候就需要用到Go的交叉编译功能。Go语言本身对交叉编译的支持非常友好，不需要额外安装复杂的工具链，只需要正确配置相关环境变量即可完成编译操作。
基础环境准备
首先需要确认Linux系统上已经正确安装了Go开发环境，并且版本符合项目需求。可以通过下面的命令检查Go的版本信息：
go version
如果命令输出类似go version go1.21.0 linux/amd64的内容，说明Go环境已经正常安装。如果还没有安装Go，需要先到官方渠道下载对应Linux平台的安装包，解压后配置好GOROOT和PATH环境变量。
核心配置步骤
设置交叉编译环境变量
Go的交叉编译主要通过两个环境变量控制，分别是GOOS和GOARCH。GOOS指定目标操作系统，GOARCH指定目标架构。如果要编译Windows平台的程序，需要设置这两个变量的值：
GOOS=windows：表示目标操作系统是WindowsGOARCH=amd64：表示目标架构是64位x86架构，如果需要32位程序可以设置为386
可以在执行编译命令时临时设置这两个变量，也可以将其写入shell配置文件实现永久生效。临时设置的编译命令示例如下：
GOOS=windows GOARCH=amd64 go build -o output.exe main.go
上面的命令会在当前目录生成名为output.exe的Windows可执行文件，main.go是项目的入口文件。
处理CGO依赖问题
如果项目中使用了CGO，也就是调用了C语言的代码，那么交叉编译会稍微复杂一些，因为需要对应平台的C编译器。对于Linux编译Windows程序的情况，需要安装MinGW-w64工具链：
# Ubuntu/Debian系统安装命令 sudo apt-get install mingw-w64 # CentOS/RHEL系统安装命令 sudo yum install mingw64-gcc
安装完成后，还需要设置CC环境变量指定Windows平台的C编译器：
GOOS=windows GOARCH=amd64 CC=x86_64-w64-mingw32-gcc CGO_ENABLED=1 go build -o output.exe main.go
如果项目没有使用CGO，可以直接设置CGO_ENABLED=0关闭CGO，这样不需要额外安装C编译器，编译命令可以简化为：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o output.exe main.go
编译结果验证
编译完成后，可以将生成的output.exe文件复制到Windows系统中运行，验证程序是否正常工作。也可以在Linux系统上通过file命令查看文件类型，确认是Windows可执行文件：
file output.exe
如果输出内容包含PE32+ executable (console) x86-64字样，说明编译生成的确实是Windows平台的64位可执行文件。
常见问题解决
编译后程序无法在Windows运行
这种情况通常是因为目标架构设置错误，比如将GOARCH设置为arm64却放在x86架构的Windows上运行，或者编译时开启了CGO但没有正确配置C编译器。可以检查环境变量设置，确认GOOS和GOARCH的值是否符合目标Windows系统的实际情况。
提示找不到包的错误
如果编译时提示找不到某个依赖包，需要先确认在Linux环境下可以正常编译运行项目，再执行交叉编译命令。可以通过go mod tidy命令整理依赖，确保所有依赖包都已经正确下载到本地。
生成的可执行文件过大
Go默认编译的可执行文件会包含运行时信息和调试符号，可以通过添加编译参数减小文件体积：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags "-s -w" -o output.exe main.go
其中-s参数会去掉符号表信息，-w参数会去掉DWARF调试信息，两者结合可以显著减小生成的可执行文件大小。
Gocross_compilationLinuxWindows修改时间：2026-07-18 15:48:11