17370845950

WSL中Go开发应使用官方二进制安装并显式配置GOROOT、GOBIN和GOPATH，全部操作须在WSL原生路径（如~/）进行，VS Code需配置为登录交互式shell（-i -l）以正确加载环境。

WSL 中安装 Go 不要用 apt 直接装

WSL 默认源里的 golang 包版本通常严重滞后（比如 Ubuntu 22.04 自带 go 1.18），且不包含 GOROOT 和 GOBIN 的合理默认值，容易导致 go install 失败或 go mod 行为异常。官方二进制包才是唯一推荐方式。

• 去 https://www./link/81836b7cd16991abb7febfd7832927fd 下载最新 go1.xx.linux-amd64.tar.gz（WSL2 一般为 x86_64）
• 解压到 /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

• 执行 source ~/.bashrc，验证：go version 应输出类似 go version go1.22.5 linux/amd64

GOBIN 和 GOPATH 要显式配置才稳定

WSL 文件系统跨 Windows/Linux 边界时，若依赖默认路径（如 $HOME/go），可能因权限、大小写敏感或缓存问题引发 go install 写入失败或 go mod download 卡住。建议统一指向 WSL 原生路径并显式声明。

• 创建专用目录：

  mkdir -p ~/go-workspace/bin

• 在 shell 配置中添加：

  export GOPATH=$HOME/go-workspace
  export GOBIN=$HOME/go-workspace/bin

• 确保 GOBIN 已在 PATH 前置：

  export PATH=$GOBIN:$PATH

• 验证：go env GOPATH 和 go env GOBIN 应返回你设置的路径

VS Code 连

接 WSL 后仍提示 “go command not found”

这是 VS Code Remote-WSL 插件加载 shell 环境不完整导致的典型问题——它默认不读取 ~/.bashrc 中的 export，所以 PATH 里没有 go。

• 打开 VS Code 设置（Ctrl+,），搜索 remote.WSL.defaultLinuxShellArgs
• 将值设为：

  ["-i", "-l"]

  （即以登录交互式 shell 启动）
• 重启 VS Code 窗口（不是仅重载窗口），再打开一个 .go 文件，状态栏应显示 Go 版本
• 如果仍不行，检查 VS Code 的集成终端是否也用了 -i -l：设置中搜 terminal.integrated.profiles.linux，确认默认 profile 含 "args": ["-i", "-l"]

Windows 文件系统（/mnt/c/）里不能直接 go run

WSL 访问 /mnt/c/ 下的 Go 项目时，go build 可能报错 exec: "gcc": executable file not found in $PATH，或 go mod 拉包极慢甚至超时。根本原因是 Windows NTFS 文件系统不支持 Unix 权限和符号链接，且 I/O 层有额外转换开销。

• 所有开发工作必须在 WSL 原生文件系统进行（即 ~、/home/xxx、/tmp 等路径）
• 不要用 code /mnt/c/Users/xxx/project 直接打开 Windows 路径；改用 cd ~ && mkdir project && code ./project
• 若需从 Windows 同步代码，用 rsync 或 Git，而非直接编辑 /mnt/c/ 下文件
• WSL2 的内存和磁盘性能对原生路径很友好，没必要妥协

WSL 上 Go 开发最常卡住的地方，不是装不上，而是路径混用 + shell 环境加载不全。只要坚持用官方二进制、显式设 GOBIN、所有操作留在 ~/ 下、VS Code 启动带 -i -l，基本不会遇到环境级阻塞。