go mod download卡住或报404主因是goproxy未正确配置，需设为https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct（逗号分隔、direct小写且置末），并配goprivate隔离私有模块。
go mod download 卡住或报 404？先看 GOPROXY 配置对不对
国内环境下 go mod download 卡在 “Fetching” 或直接返回 404，90% 是 GOPROXY 没设对——不是网络不通，而是代理链没 fallback、direct 没放末尾，或私有域名没隔离。
-
go env -w GOPROXY=https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct（逗号分隔，不能有空格，direct必须小写且在最后） - 如果公司 Git 地址是
git.internal.company.com，必须加：go env -w GOPRIVATE=git.internal.company.com - 若该域名走 HTTP（非 HTTPS），再补：
go env -w GOINSECURE=git.internal.company.com - 验证是否生效：
go env GOPROXY输出应与你设置的完全一致，不是默认的https://proxy.golang.org,direct
内网服务想被外网访问？别用反向代理硬扛，先确认穿透模式
单纯起一个 http.ReverseProxy 只能做同网段转发，无法穿透 NAT。真正解决“外网访问内网服务”，得选对模型：
- 主动连接型（推荐）：内网 client 主动连公网 server（如
ccproxy或自研隧道），server 分配唯一路径（如/tunnel/abc123）转发请求——适合无公网 IP 场景 - 反向代理型：仅当内网机器有固定公网 IP 或端口映射权限时可用，直接监听
:8080并Director到http://192.168.1.100:3000 - 注意：Go 标准库
net/http/httputil.NewSingleHostReverseProxy不处理 WebSocket 升级，需手动复制Upgrade头和Connection头
自己搭代理服务，为什么 gopls 总报错？GOBIN 和 PATH 得对齐
VS Code 提示 Failed to start language server，大概率是 gopls 没装、装错位置，或终端根本找不到它。
- 装最新版：
go install golang.org/x/tools/gopls@latest（Go 1.23+ 要用此命令，不是go get） - 确认
$GOBIN已设且加入PATH：Linux/macOS 运行echo $GOBIN应输出类似/home/user/go/bin；Windows PowerShell 中$env:GOBIN和$env:Path都得包含该路径 - 别让
GOROOT/bin和$GOBIN同时在PATH里——冲突时优先取前者，可能加载旧版gopls - 装完后运行
gopls version验证可执行，再重启 VS Code
模块拉不到私有仓库？GONOSUMDB 和 git 配置得配套上
即使 GOPRIVATE 设了，go mod download 仍报 checksum mismatch，说明 Go 还在尝试校验，而你的私有模块没进官方 checksum DB。
- 补上：
go env -w GONOSUMDB=git.internal.company.com - Git 层也要配代理（和
GOPROXY无关）：git config --global http.proxy http://127.0.0.1:8080 - 若用 SSH 克隆（
git@xxx），则不用 HTTP 代理，但需确保~/.ssh/config里 Host 别名解析正确，且ssh -T git@xxx能通 - 项目根目录下若有
go.work，它会覆盖全局GOPRIVATE，此时得在go.work里显式写use ./...并检查 workspace 级配置
GOPRIVATE，又出现在 GONOSUMDB，但 GOINSECURE 没同步加上——只要其中一项缺失，go mod 就可能静默失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
