Go环境配置问题包括：PATH未包含GOROOT/bin导致go version报错；go mod init失败因未指定模块路径或路径含空格/中文；go get超时需设置GOPROXY为国内镜像并保留direct后缀。
go version 命令报错或不识别
说明 Go 二进制未进入系统 PATH，或安装根本没完成。Windows 用户常见于 MSI 安装后没重启终端，或手动解压安装时漏配 GOROOT 和 PATH。
- 先确认安装包是否真正执行完毕：Windows 看
C:\Go\bin\go.exe是否存在；macOS/Linux 检查/usr/local/go/bin/go或你自定义的$GOROOT/bin/go - 运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认$GOROOT/bin（如C:\Go\bin）在输出中 - 若刚配置完环境变量，必须新开终端窗口——旧窗口不会自动加载新变量
- 别用
go --version，正确命令是go version；输错会提示unknown flag，不是环境问题
go mod init 失败：‘cannot determine module path’
这是模块初始化最常卡住的地方，本质是当前目录没在 GOPATH 下，又没显式指定模块名，go mod init 不知道该起什么名字。
- 直接加参数指定路径：
go mod init example.com/myapp，域名部分可随意（甚至用myproject也行），只要合法、不冲突 - 不要在
$GOPATH/src下初始化模块——Go 1.11+ 模块模式下，项目可放在任意位置，刻意避开 GOPATH 反而更干净 - 如果目录名含空格或中文，
go mod init会静默失败，改用纯英文路径再试 - 检查当前目录是否有残留的
go.mod或vendor/，有就删掉重来
go get 被墙或超时
国内直连 proxy.golang.org 基本不可用，不设代理就卡在 fetch 阶段，错误常是 timeout 或 no such host。
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（推荐国内镜像）或https://mirrors.aliyun.com/goproxy/ -
direct是关键后缀，表示对私有仓库（如公司内网 Git）跳过代理，直接拉取 - 验证是否生效：
go env GOPROXY应输出你刚设的地址；若仍显示空白，说明go env -w在旧版 Go（set GOPROXY=...（Windows）或export GOPROXY=...（macOS/Linux） - 个别包（如
golang.org/x/...）还可能触发go get的隐式重定向逻辑，此时加-u参数反而容易失败，优先不加
VS Code 中没有代码补全或跳转定义
不是插件没装，而是 gopls 语言服务器没跑起来，或者被旧工具（如 gocode）干扰。
立即学习“go语言免费学习笔记（深入）”；
- 确保已安装官方
Go插件（作者是Go Team at Google），禁用所有标着 “legacy” 或 “deprecated” 的 Go 相关插件 - 在 VS Code 设置里搜
go.goplsArgs，清空该字段——默认值已足够，乱填参数（如加-rpc.trace）会导致启动失败 - 打开命令面板（
Ctrl+Shift+P），运行Go: Install/Update Tools，勾选全部，尤其是gopls，让它重装一遍 - 检查项目根目录是否有
go.work文件：有则说明是多模块工作区，gopls会按此文件加载，删掉它可强制退回到单模块模式快速验证
GOPROXY 设错会影响 go mod download，进而让 gopls 加载失败，最终表现为编辑器“失能”。每次只动一个变量，用 go env 确认实际生效值，比猜更快。 
