go version无反应是因path未生效，需验证并重载配置；go mod init报错因路径含空格或中文；go run找不到包是误用gopath旧结构；国内依赖失败需设置goproxy为goproxy.cn。
go version 命令没反应？先确认 PATH 是否生效
安装完 Go 后输入 go version 报 command not found 或直接无输出，90% 是环境变量没生效。这不是安装失败，而是 shell 没读到新配置。
- Windows 用户：安装 .msi 时勾选了 “Add Go to PATH” 才会自动配置；若没勾选，需手动把
C:\Go\bin加进系统环境变量的Path - macOS/Linux 用户：改完
~/.zshrc或~/.bashrc后，必须运行source ~/.zshrc（或对应文件），新开终端才继承新环境 - 验证是否真生效：执行
echo $PATH，看输出里有没有/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows）
go mod init 报错“no such file or directory”？项目路径不能含空格或中文
go mod init 是现代 Go 项目的起点，但它对当前目录路径很敏感。报这个错误不是模块系统坏了，而是 shell 解析路径失败。
- 避免路径中出现空格，比如
/Users/username/My Projects/hello-go→ 改成/Users/username/my-projects/hello-go - 绝对不要用中文路径，如
桌面/我的Go项目会触发编码和权限问题 - 推荐做法：用
mkdir ~/go-projects/hello && cd ~/go-projects/hello创建纯英文路径 - 执行
go mod init hello即可生成go.mod，无需带域名前缀也能跑通
go run main.go 提示“cannot find package”？别碰 GOPATH/src 老结构
新手常误以为必须把代码放进 $GOPATH/src 才能运行，结果新建项目放错位置，go run 就找不到包。
- Go 1.16+ 默认启用 modules，
go run只认当前目录下的go.mod和main.go，跟GOPATH无关 - 只要目录里有
go.mod，哪怕在/tmp/test或 U 盘里，go run main.go都能正常工作 - 如果还依赖老式
GOPATH工作流（比如维护旧项目），请确保main.go在$GOPATH/src/xxx/yyy下，且xxx/yyy是合法导入路径 - 检查方式：
go env GOPATH看值，再确认你的文件是否真在$GOPATH/src子目录里
国内拉依赖超时或失败？GOPROXY 必须设，但别硬写死
首次 go run 或 go mod tidy 时卡住几十秒后报错，大概率是模块代理没配好。这不是网络问题，而是 Go 默认用境外源。
- 推荐命令一次性配好：
go env -w GOPROXY=https://goproxy.cn,direct（goproxy.cn稳定、免认证、支持私有模块） - 不要写成
https://proxy.golang.org,direct—— 这个地址在国内基本不可达 - 如果公司内网有私有代理（如 Artifactory），用
go env -w GOPROXY=https://your-proxy/artifactory/go-proxy/,direct - 验证是否生效：
go env GOPROXY输出应是你刚设置的地址，不是空或默认值
go mod init 后不立即执行 go mod tidy，导致后续加依赖时路径解析混乱；而 go mod tidy 又依赖 GOPROXY 正确设置——这两步必须连着做，中间不能断。**golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
