go version没反应是因path未生效，需重启终端或确认路径；go env显示gopath为空属正常，go 1.16+默认启用模块模式；go run报“cannot find module”需先执行go mod init初始化模块；代理未配置会导致go get卡住，应设goproxy为国内镜像。
go version 命令没反应？先确认安装是否真完成
直接运行 go version 报 “不是内部或外部命令”，说明 PATH 没生效，不是 Go 没装好，而是系统没找到它。
- Windows 上用 MSI 安装后，需**重启终端**（CMD/PowerShell）或**注销重登录**——环境变量不会自动刷新到已打开的窗口
- macOS/Linux 用
.pkg或tar.gz安装后，检查PATH是否含/usr/local/go/bin（macOS 默认）或$GOROOT/bin（Linux 手动解压时） - 别信“安装完就能用”，执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows）亲眼确认路径存在
go env 显示 GOPATH 是空？Go Modules 已默认启用
Go 1.16+ 版本起，GO111MODULE 默认为 on，不再强制依赖 GOPATH/src 目录结构。此时 go env GOPATH 可能返回空或仅用于存放工具（如 gopls），这属于正常行为。
- 新建项目只需在任意目录下运行
go mod init myproject，即可初始化模块，后续go run、go build全部走模块路径 - 若仍想显式设置
GOPATH（例如要复用旧项目结构），可手动设为非中文、无空格路径，如C:\gopath或~/go - 误删
GOPATH不影响新项目，但go install生成的二进制会默认放在$GOPATH/bin，没设就找不到可执行文件
go run main.go 提示 “cannot find module”？模块初始化漏了
这是新手最常卡住的地方：文件存在、语法正确，但就是跑不起来，错误里带 no required module provides package。
- 必须先在该目录下执行
go mod init example.com/hello（模块名可任意，但建议符合域名格式） - 执行后生成
go.mod文件，内容至少包含module example.com/hello和go 1.21（或当前版本） - 如果已有
go.mod但提示路径不匹配，检查模块名是否和当前目录层级冲突（比如在~/foo/bar下用了go mod init foo，而实际 import 是"foo/bar"）
代理没配导致 go get 卡住？优先用国内镜像
执行 go get 或 go mod download 时长时间无响应，大概率是模块代理没开，不是网络问题本身。
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org,direct（官方，需科学上网） - 加
,direct表示对私有仓库跳过代理，避免公司内网模块拉取失败 - 验证是否生效：运行
go env GOPROXY，输出应为设置的地址，而非空或https://proxy.golang.org - 注意：某些企业防火墙会拦截
goproxy.cn，可临时换为https://goproxy.io,direct或自建athens
真正容易被忽略的是：模块初始化和代理配置这两步，既不报错也不提示，但缺一不可。很多“环境搭好了却跑不了代码”的问题，根源就在这两个静默环节。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
