在WSL中进行Golang环境搭建的注意事项_技术教程

WSL中安装Go必须用官方二进制包，因其版本精准、路径干净、升级方便；GOPATH须设在WSL原生文件系统（如~/go），禁用/mnt/路径；需配置GOPROXY为清华源并安装build-essential等构建工具。

WSL中安装Go必须用官方二进制包，别用apt

Ubuntu/Debian的 apt install golang 安装的是系统维护的旧版本（如 1.18 或更早），且 GOPATH 和 GOROOT 配置常不一致，容易和 go install 的模块路径冲突。官方二进制包能精准控制版本、路径干净、升级方便。

从 https://www./link/81836b7cd16991abb7febfd7832927fd 下载最新 go1.xx.x.linux-amd64.tar.gz

解压到 /usr/local：

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz

把 /usr/local/go/bin 加入 $PATH（写入 ~/.bashrc 或 ~/.zshrc）：
```
export PATH=$PATH:/usr/local/go/bin
```
重启 shell 或运行 source ~/.bashrc，验证：go version 应输出正确版本

WSL的GOPATH默认不能设在Windows挂载目录下

WSL 访问 Windows 文件（如 /mnt/c/Users/xxx）走的是 drvfs，不支持 Unix socket、文件锁、符号链接等 Go 构建所需特性。若把 GOBIN 或项目放在 /mnt/ 下，go build 可能静默失败或报 operation not permitted。

go env -w GOPATH=$HOME/go（推荐保持默认，即 ~/go）
项目代码务必放在 WSL 原生文件系统内，例如：~/projects/myapp，而非 /mnt/c/dev/myapp
如果必须跨系统编辑，用 VS Code Remote-WSL 插件打开 WSL 内路径，不
要直接打开 /mnt/

go mod tidy 在WSL中可能因代理/网络卡住

国内用户直连 proxy.golang.org 或 sum.golang.org 经常超时或返回 403，导致 go mod tidy 卡在 “verifying” 阶段，终端无报错但长时间不动。

设置 GOPROXY（推荐清华源）：

go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct

关闭校验（仅开发调试用，勿用于生产）：
```
go env -w GOSUMDB=off
```
确认生效：go env GOPROXY GOSUMDB
注意：WSL2 默认使用主机网络，若主机开了代理软件（如 Clash、Surge），需确保其监听地址为 0.0.0.0:7890 并允许局域网连接，否则 WSL 内无法走代理

CGO_ENABLED=1 时编译 C 依赖会失败，除非装齐构建工具

很多 Go 包（如 sqlite3、net 标准库部分功能）启用 CGO_ENABLED=1（默认开启）后需调用系统 C 编译器和头文件。WSL 默认不带 build-essential，直接报错 gcc: command not found 或 fatal error: sys/socket.h: No such file or directory。

运行：

sudo apt update && sudo apt install -y build-essential pkg-config

若用 SQLite、OpenSSL 等，还需额外安装：
```
sudo apt install -y libsqlite3-dev libssl-dev
```
临时禁用 CGO（仅限纯 Go 项目）：
```
CGO_ENABLED=0 go build
```
，但会导致 net.LookupIP 等行为降级（用 Go 自实现 DNS 而非系统解析器）