基于WSL2的Golang开发环境搭建与混合编译踩坑指南-Golang-PHP中文网

wsl2中go命令找不到需先确认path和安装方式：wsl2默认不带go，应下载官方linux-amd64二进制包解压至/usr/local，再将/usr/local/go/bin加入~/.bashrc的path并source生效，验证go version与which go。

基于wsl2的golang开发环境搭建与混合编译踩坑指南

WSL2默认不带go，直接apt install golang装的是系统包管理器维护的旧版本（比如Ubuntu 22.04是go1.18），容易和GOROOT/GOBIN冲突。官方二进制包才是最稳的选择。

去https://go.dev/dl/下载go1.xx.linux-amd64.tar.gz（注意选linux-amd64，不是windows-amd64）
解压到/usr/local：sudo tar -C /usr/local -xzf go*.tar.gz
在~/.bashrc或~/.zshrc末尾加：export PATH=$PATH:/usr/local/go/bin，然后source ~/.bashrc
验证：go version应输出类似go version go1.22.5 linux/amd64；which go应返回/usr/local/go/bin/go

/mnt/c/挂载Windows盘，但NTFS→9P协议桥接带来明显IO延迟，go build、go test、模块下载都可能卡顿几秒甚至更久。

开发项目务必放在WSL2原生文件系统里，比如~/go/src/github.com/xxx或/home/username/myproject
go mod download缓存默认在$GOPATH/pkg/mod，这个路径也得在WSL2内——别设成/mnt/c/Users/xxx/go/pkg/mod
如果用VS Code Remote - WSL打开项目，必须在WSL终端里执行code .启动编辑器，它会自动走本地路径，不经过/mnt/c

在WSL2里执行GOOS=windows GOARCH=amd64 go build报错exec: "gcc": executable file not found in $PATH或链接失败，不是环境变量问题，而是根本没装Windows目标平台的C工具链。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

装MinGW-w64：sudo apt install gcc-mingw-w64
纯Go项目（无cgo）直接关CGO：CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build
含cgo的项目需启用CGO并指定链接器：CGO_ENABLED=1 CC_FOR_TARGET=x86_64-w64-mingw32-gcc GOOS=windows GOARCH=amd64 go build
生成的.exe无法在WSL2里运行，必须复制回Windows侧测试

断点灰色、跳过、或提示could not launch process: fork/exec /p...，常见原因有两个：调试器版本与Go不兼容，或VS Code没加载完整的shell环境。

用go install装匹配当前Go版本的dlv：go install github.com/go-delve/delve/cmd/dlv@latest（注意不是go get）
VS Code Remote-WSL默认不读~/.bashrc，需手动配置登录交互式shell：设置中搜remote.WSL.defaultLinuxShellArgs，设为["-i", "-l"]
重启整个VS Code窗口（不是重载窗口），再打开.go文件，状态栏应显示Go版本；集成终端也要确认terminal.integrated.profiles.linux含"args": ["-i", "-l"]