go get失败主因是GOPROXY配置或网络问题，应设为goproxy.cn,direct；GOROOT需正确指向Go安装路径且不显式设GOPATH；VSCode断点失效多因gopls/dlv未装或版本不匹配；log无行号需在main.go的init()首行调用log.SetFlags。
go get 依赖下载失败：先看 GOPROXY 和网络连通性
绝大多数“go get 失败”不是 Go 本身的问题，而是代理或网络策略拦住了对 proxy.golang.org 的访问。企业内网、校园网、某些云主机默认会屏蔽境外域名，导致连接超时或 TLS 握手失败。
快速验证方法：
- 运行
curl -v https://proxy.golang.org—— 如果报SSL certificate problem，大概率是系统时间不准（尤其是 Docker 容器或虚拟机）；如果卡住或返回Connection timed out，说明网络不通 - 检查当前代理设置：
go env GOPROXY。若输出为空或为direct，Go 就会直连官方源，大概率失败 - 临时生效国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/
注意：GOPROXY 值末尾的 direct 很关键——它表示当镜像站没命中时，回落到直接拉取，避免私有模块（如公司内网 Git）被强制走代理。
GOROOT 和 GOPATH 配置错误：新版 Go 已不强制要求 GOPATH
Go 1.16+ 默认启用 GO111MODULE=on，项目只要存在 go.mod 文件，就自动进入 module 模式，GOPATH 对依赖管理已无实质影响。但很多人仍习惯性配置它，反而引发冲突。
立即学习“go语言免费学习笔记（深入）”；
常见误操作：
- 手动设置
GOPATH后，又在非$GOPATH/src目录下执行go mod init，结果go list找不到本地包 - 把
GOROOT错设成自己项目的根目录（应指向 Go 安装路径，如/usr/local/go或C:\Program Files\Go） - 多个 Go 版本共存时，
PATH中的go可执行文件和GOROOT不匹配，导致go version和go env GOROOT输出不一致
建议做法：不显式设置 GOPATH，只确保 GOROOT 正确且 $GOROOT/bin 在 PATH 中；用 go mod init myapp 初始化项目，依赖自动存到 $GOPATH/pkg/mod 下，与项目位置无关。
VSCode 调试不触发断点：gopls 和 dlv 没装全或版本不匹配
VSCode 的 Go 扩展依赖 gopls（语言服务器）和 dlv（调试器）协同工作。断点不命中、变量无法查看、跳转失效，90% 是这两个工具缺失或版本错配。
排查步骤：
- 在 VSCode 命令面板中运行
Go: Install/Update Tools，勾选全部，尤其不能漏掉gopls、dlv、go-outline - 终端执行
dlv version，确认输出中Build字段的 Go 版本与当前go version一致；若不一致，删掉旧dlv二进制重新安装 - 检查 VSCode 设置里是否启用了
go.toolsManagement.autoUpdate，关掉它可避免插件自动覆盖你手动安装的版本 - 确保项目根目录包含
go.mod，且 VSCode 是以该目录为工作区打开的（不是只打开单个.go文件）
一个典型现象：dlv 启动后立即退出，日志显示 could not launch process: fork/exec ... no such file or directory——这往往是因为 dlv 编译时链接了不存在的 libc 版本，换用静态编译版（如从 Delve Release 页面 下载预编译二进制）即可解决。
错误堆栈不带文件行号：log 包初始化时机不对
Go 的 error 值本身不带调用栈，打印时只输出字符串。想让日志自动带 文件名:行号，必须提前调用 log.SetFlags()，且不能晚于第一次 log.Print* 调用。
最容易忽略的点：
- 在某个子包的
init()函数里调用log.SetFlags()，但主包的log.Println()已先执行过——此时设置无效 - 使用了第三方日志库（如
zap、logrus），却误以为log.SetFlags()对它们也起作用 - 在
main()函数开头才设置，但中间有其他包（比如数据库驱动）内部调用了log，导致首条日志仍无位置信息
稳妥做法：在项目最顶层的 main.go 的 init() 函数第一行就写 log.SetFlags(log.Lshortfile | log.LstdFlags)；如果要用绝对路径，换成 log.Llongfile。别指望靠 fmt.Printf 或 panic 来定位——它们不经过 log 包，自然不受影响。
