必须手动设置GOPATH、GOBIN和GOPROXY三个环境变量：GOPATH设为$HOME/go，GOBIN设为$GOPATH/bin，GOPROXY设为https://goproxy.cn,direct；否则go mod download会卡住、go run找不到包、IDE调试报错。
Go 开发环境不是装完 go 命令就完事——没配好 GOPATH、GOBIN 或代理，go mod download 会卡住，go run 找不到包，IDE 调试直接报错。
确认 go 安装是否真正可用
很多人执行 go version 看到输出就以为成了，但实际可能只是 PATH 里混进了旧版本或 alias。关键要验证三件事：
- 运行
which go（macOS/Linux）或where go（Windows），确认路径指向你刚安装的目录，比如/usr/local/go/bin/go或C:\Go\bin\go.exe - 执行
go env GOPATH，如果输出空或$HOME/go以外的路径，说明没生效或被其他配置覆盖 - 新建一个
hello.go，内容为package main; import "fmt"; func main() { fmt.Println("ok") }，用go run hello.go运行——不能依赖 IDE 的“一键运行”，必须命令行可通
必须手动设置的三个环境变量
Go 1.16+ 默认启用模块模式，但 GOPATH 仍影响 go install 输出位置和本地包引用；GOBIN 决定二进制文件放哪；代理则解决国内拉包失败问题。不设它们，go get 会超时或 404。
-
GOPATH：建议显式设为$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows），避免默认值被 shell 配置意外覆盖 -
GOBIN：设为$GOPATH/bin，这样go install的工具（如gopls、delve）能被 shell 直接调用 -
GOPROXY：设为https://goproxy.cn,direct（国内推荐），不要只写https://goproxy.cn，缺了,direct会导致私有模块无法拉取
VS Code + Go 插件常见失效场景
装完插件发现代码不提示、跳转失效、断点不命中？大概率是 gopls 没跑起来，或工作区没识别为 Go 模块。
立即学习“go语言免费学习笔记（深入）”；
- 打开项目根目录（含
go.mod的文件夹），而不是父级目录——gopls依赖go.mod定位模块边界 - 在 VS Code 终端里执行
go install golang.org/x/tools/gopls@latest，确保二进制落在$GOBIN下，并被 PATH 包含 - 检查 VS Code 设置里的
"go.toolsGopath"是否为空，若填了路径，删掉——新版插件不再需要它 - 如果编辑器右下角显示 “Loading…” 卡住，按
Ctrl+Shift+P→ 输入 “Go: Restart Language Server” 强制重载
go mod init 后仍找不到本地包？
这是新手最常卡住的地方：明明写了 import "myproj/utils"，却报 no required module provides package。根本原因不是路径错，而是模块路径没对齐。
-
go mod init的参数必须是未来要发布的模块路径，比如go mod init github.com/yourname/myproj，不能是go mod init myproj - 本地子包路径必须匹配
module行声明的前缀，例如module github.com/yourname/myproj，那么import "github.com/yourname/myproj/utils"才合法 - 如果只是本地开发不想发 GitHub，可用伪域名如
go mod init example.com/myproj，只要所有import前缀一致即可
环境变量和模块路径的拼写、斜杠方向、大小写，任何一个字符错了都会让 Go 工具链静默失败——它不会告诉你哪错了，只会说“找不到”。调试时优先查 go env 输出和 go list -m 结果，比翻日志快得多。
