如何使用Golang在WSL中开发_Golang WSL环境搭建方法_网络技术

如何使用Golang在WSL中开发_Golang WSL环境搭建方法

发布时间 - 2026-01-25 00:00:00 点击率：次

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，基本不会遇到环境级阻塞。

# linux # git # go # windows # golang # ubuntu # unix # amd # 解压 # win # vs code # https # 文件系统 # 加载 # 不要用 # 这是 # 设为 # 不上 # 用了 # 已在 # 不支持 # 自带

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：vscode搜索替换技巧_vscode全局替换使用指南

下一篇：vscode怎么调试网页 vscode浏览器调试的配置指南

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：vscode搜索替换技巧_vscode全局替换使用指南

下一篇：vscode怎么调试网页 vscode浏览器调试的配置指南