在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.php.cn/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” 阶段，终端无报错但长时间不动。

Rationale

Rationale 是一款可帮助企业主、经理和个人做出艰难的决定的AI工具

下载

• 设置 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。

立即学习“go语言免费学习笔记（深入）”；

• 运行：

  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 而非系统解析器）