必须显式设置GOOS=windows，因为Go编译器仅在此环境下生成Windows所需的PE格式可执行文件，否则默认产出当前系统（如Linux ELF或macOS Mach-O）二进制，即使加.exe后缀也无法在Windows运行。
GOOS=windows 为什么必须显式设置
不设 GOOS=windows，你在 Linux 或 macOS 上跑 go build，生成的永远是当前系统的二进制（比如 macOS 的 Mach-O），哪怕你硬加上 .exe 后缀，Windows 也根本打不开——双击没反应，右键属性里“兼容性”选项灰掉，用 file 命令看会显示 “ELF” 或 “Mach-O”，不是 PE 格式。
Windows 可执行文件有严格格式要求：PE 头、入口点、导入表等。Go 编译器只在 GOOS=windows 时才生成符合规范的 PE 文件。它不是“加个后缀就行”，而是整个目标平台切换。
-
GOOS=windows是硬性前提，缺它必失败 -
GOARCH=amd64强烈建议一并指定，避免某些 Go 版本下默认用386（Win10/11 默认不带 32 位子系统） - PowerShell 用户别用
export，改用$env:GOOS="windows"; $env:GOARCH="amd64"，或更稳妥的写法：cmd /c "set GOOS=windows && set GOARCH=amd64 && go build -o app.exe main.go"
CGO_ENABLED=0 到底要不要关
默认开启 CGO_ENABLED=1，Go 会尝试调用 C 工具链链接 Windows 系统库（msvcrt.dll、vcruntime140.dll）。结果就是：exe 在你开发机上能跑，发给同事却弹窗报错“找不到 vcruntime140.dll”。
关掉它（CGO_ENABLED=0）能生成真正静态链接的单文件，但代价真实存在：
立即学习“go语言免费学习笔记（深入）”；
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
-
net包退化为纯 Go DNS 解析器：不读 Windows 的hosts、不走系统 DNS 设置、不支持 SRV 记录 -
os/user返回空用户名和无效 UID/GID，因为无法调GetUserNameEx -
os/exec无法继承父进程环境变量（Windows 下需 cgo 控制CreateProcess的bInheritHandles） - 如果你代码里用了
// #include <windows.h>或syscall调 C 函数，CGO_ENABLED=0直接编译失败
结论：纯工具类程序（无网络配置依赖、不查用户信息、不调 Win32 API），直接加 CGO_ENABLED=0；否则得配 MinGW-w64 工具链，或接受分发时附带 VC++ 运行时。
交叉编译时路径和系统调用怎么不翻车
Go 不会在编译期检查你写的代码是否能在 Windows 上运行。你写 exec.Command("bash", "-c", "ls") 或 os.Open("/proc/cpuinfo")，Linux/macOS 上 go build 成功，但生成的 exe 拷到 Windows 上一运行就 panic：“exec: "bash": executable file not found” 或 “stat /proc: no such file or directory”。
- 命令行工具别硬写
"bash"、"sh"、"ls"，改用exec.Command("cmd", "/c", "dir") - 路径拼接必须用
filepath.Join()，而不是字符串拼"C:/tmp/" + name - 判断平台别用
strings.Contains(runtime.Version(), "windows")，改用runtime.GOOS == "windows" - 临时目录用
os.TempDir()，别写死/tmp或C:\temp
图标和版本信息不是“锦上添花”，而是发布前最后一关
Go 原生完全不支持嵌入 Windows 资源（图标、文件描述、公司名、UAC 清单）。你编译出的 app.exe 右键 → 属性 → “详细信息” 标签页里全是空白，图标是那个刺眼的白色窗口——这不是美观问题，是信任问题。用户第一眼看到的就是这个。
现在主流做法是用 go-winres：
- 写一个
version.json描述元数据（FileDescription、CompanyName、ProductVersion等） - 准备一个含多尺寸（16×16、32×32、48×48、256×256）的
icon.ico - 执行
go-winres make，生成resources.syso - 最后编译时带上它：
go build -o app.exe main.go resources.syso
注意：resources.syso 必须和 main.go 在同一目录，且名字不能改；如果用了 CGO_ENABLED=0，它依然生效——因为资源注入发生在链接阶段，和 cgo 无关。
