Go项目go get卡住或报错主因是GOPROXY未生效，国内需设为https://goproxy.cn,direct；依赖必须用语义化版本锁定（如@v1.12.0），避免@latest引发v2路径变更；go mod tidy可补全缺失依赖并校准状态。
go 命令能正常执行，就说明基础环境已就位；但真正影响开发效率的，是模块初始化方式、依赖拉取路径、以及国内网络下如何绕过代理失败——这些才是你写第一行 go run 之前最该确认的事。
go mod init 后为什么 go get 总卡住或报错？
不是代码问题，而是 GOPROXY 没生效。Go 1.13+ 默认启用模块模式，但默认 proxy 是 https://proxy.golang.org，国内直连基本超时。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，阿里云维护，稳定） - 如果公司内网有私有 proxy，换成
https://your-internal-proxy.com - 临时关闭 proxy 测试：
go env -w GOPROXY=direct，仅用于排查是否为代理问题 - 验证是否生效：
go env GOPROXY应输出你刚设置的地址
常用标准库不用拉取，但第三方包怎么选版本？
Go 没有“最新版”概念，go get 默认拉取 latest commit（非 tag），容易导致行为不一致。生产项目必须锁定语义化版本。
- 明确指定版本：
go get github.com/gin-gonic/gin@v1.12.0 - 用
@latest要谨慎：go get github.com/sirupsen/logrus@latest可能拉到 v2.x，而 v2 导入路径已变（github.com/sirupsen/logrus/v2） - 查看可用版本：
go list -m -versions github.com/spf13/cobra - 升级所有依赖到兼容最新主版本：
go get -u；只升级补丁版：go get -u=patch
CentOS 7 上 go install 失败：command not found
常见于手动解压安装后 PATH 未生效，或 /usr/local/go/bin 不在 shell 初始化文件中。
- 检查二进制是否存在：
ls /usr/local/go/bin/go - 临时生效：
export PATH=$PATH:/usr/local/go/bin - 永久生效：把这行加到
~/.bashrc或/etc/profile（需 root），然后source ~/.bashrc - 别漏掉
GOROOT：虽然多数情况自动推导，但显式设置更稳：go env -w GOROOT=/usr/local/go
go run 和 go build 的依赖行为差异
两者都触发模块下载，但缓存策略和错误提示粒度不同，新手常在这里误判问题来源。
立即学习“go语言免费学习笔记（深入）”；
-
go run main.go：会编译并运行，但不生成可执行文件；失败时错误信息聚焦在 main 包及其直接依赖 -
go build -o app：生成二进制，同时校验所有 transitive 依赖；若某间接依赖缺失或版本冲突，它比go run更早暴露 - 若
go run成功但go build报错，大概率是某个依赖的 sub-module（如golang.org/x/sys）没被显式 require，靠隐式导入侥幸通过 - 解决办法：
go mod tidy—— 它会补全缺失依赖、移除未使用项，是最接近“真实构建状态”的同步命令
go.mod 文件里一行没写对的 require，或是 GOPROXY 设置后忘了 source 当前 shell。这些细节不抛错，但让后续每一步都慢半拍。 
