Go 1.16+ 默认启用 GO111MODULE=on，go get 可拉取 GitHub 包但需满足规范结构和完整路径；常见错误包括无 tag、未在根目录执行、未显式指定版本；国内需设 GOPROXY=https://goproxy.cn,direct；import 不生效需检查 go.mod、路径一致性及导出符号；推荐优先用 go mod tidy 自动管理依赖。
Go 1.16+ 默认启用 GO111MODULE=on，直接用 go get 就能拉取远程模块，但实际中常因网络、代理、版本写法或 go.mod 状态出错。
go get 能不能直接拉 GitHub 上的包？
可以，但必须满足：目标仓库有符合 Go Module 规范的结构（含 go.mod 文件），且路径是完整导入路径（如 github.com/gin-gonic/gin）。
常见错误现象：
-
go get github.com/xxx/yyy报unknown revision：仓库没打 tag，或默认分支不是main/master - 拉下来却没出现在
go.mod里：没在 module 根目录执行，或当前目录没有go.mod - 拉的是旧版（比如 v1.0.0）而不是最新版：没加版本后缀，
go get默认只升级 patch 版本
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先确认你在项目根目录（有
go.mod的地方）执行命令 - 想拉特定版本，显式指定：
go get github.com/xxx/yyy@v1.2.3或@main、@commit-hash - 想强制更新到最新兼容版（minor 升级），用：
go get -u github.com/xxx/yyy - 想更新到最新主版本（可能破坏兼容性），用：
go get github.com/xxx/yyy@latest
国内拉不到 golang.org/x/... 怎么办？
这是最典型的网络问题。golang.org/x/... 域名在国内无法直连，但 Go 官方提供了镜像代理：https://goproxy.io 和 https://goproxy.cn（推荐后者，对中文用户更稳定）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 设置 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示对私有域名（如公司内网模块）不走代理，直接拉取 - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司有私有 proxy，可设为：
https://your-proxy.example.com,direct
注意：不要用 export GOPROXY=... 临时设置，容易漏掉或冲突；用 go env -w 持久化更可靠。
go get 后为什么 import 不生效？
不是所有 go get 成功的包都能立刻 import。关键看三件事：
- 模块是否已写入
go.mod—— 运行go get后检查文件末尾是否有对应require行 - 导入路径是否和
go.mod中声明的模块路径一致（大小写、拼写、子路径都不能错） - 目标包是否导出了可访问的符号（比如
package main不能被其他模块 import）
例如，执行了 go get github.com/spf13/cobra@v1.8.0，但在代码里写 import "github.com/spf13/cobra/cmd" 是错的 —— 正确路径是 github.com/spf13/cobra，子命令逻辑需通过 cobra.Command 构建，不是单独 import 子路径。
调试建议：
- 运行
go list -m all | grep xxx确认模块是否已加载 - 用
go mod graph | grep xxx查依赖关系是否成环或冲突 - 删掉
go.sum后再go mod tidy，有时校验失败会卡住 import 解析
go mod tidy
这行命令比 go get 更值得日常使用：它自动补全缺失依赖、清理未引用项、校验 go.sum，而且不改代码就能让 import 生效 —— 很多人卡在“明明 go get 了却 import 报错”，其实缺的就是这一句。
