结论：unknown import path 错误主因是网络代理或环境配置问题，非代码错误；需确保 GO111MODULE=on、正确设置 GOPROXY（如 https://goproxy.io,direct）、清除系统代理，并在 IDE 中显式配置 GOROOT。
直接说结论：这不是代码写错了，而是 Go 没法连上源站或找不到包路径——unknown import path 错误几乎全是环境配置或网络代理惹的祸。
go mod init 后 go mod tidy 报 unknown import path
这是最常见场景：项目已初始化 module，但 go mod tidy 卡在某个包上，报类似 unknown import path "golang.org/x/sys"。
- 根本原因不是包不存在，而是 Go 尝试从
https://golang.org/x/...直连失败（国内被墙） -
GO111MODULE=on必须生效，否则go mod命令不启用 - 必须设置
GOPROXY，推荐用https://goproxy.io,direct或https://proxy.golang.org,direct - 执行命令确认：
go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.io,direct - 如果之前设过代理（比如
http_proxy），建议临时清空：unset http_proxy https_proxy，避免干扰模块下载
命令行能跑，IDE（GoLand/VSCode）里标红报错
典型现象是 can't find import: "math/rand" 或 undefined: time.Duration —— 这说明 IDE 没读到你的 Go 环境变量。
- GOROOT 必须指向真实的 Go 安装目录（比如
/usr/local/go或C:\Go），不能是空、错位或软链接失效路径 - GOPATH 不影响 module 项目，但 IDE 可能仍依赖它定位标准库；确保
go env GOROOT输出与你本地安装一致 - 图形界面启动的 IDE 不继承 shell 的
.zshrc或.bashrc，需在 IDE 设置里手动填入 GOROOT（GoLand：Settings → Go → GOROOT） - VSCode 用户检查
go.goroot配置项是否正确，别让它 fallback 到空值或旧版本
go get github.com/xxx/yyy 失败，提示 connection attempt failed
错误信息里带 dial tcp ... connectex: A connection attempt failed，基本锁定为代理冲突。
立即学习“go语言免费学习笔记（深入）”；
- 检查是否全局设置了
http_proxy或https_proxy（env | grep proxy） - Go 的
GOPROXY和系统级http_proxy会打架：前者走 HTTPS 代理拉模块，后者可能让go get尝试走 HTTP 代理连原始 Git 地址 - 解决方案：优先用
GOPROXY，禁用系统代理：unset http_proxy https_proxy；若必须用代理，改用git config --global url."https://".insteadOf "git://"避免 git 协议阻塞 - Windows 用户注意：PowerShell 和 CMD 的环境变量不互通，检查当前终端实际生效的变量
App Engine 或老式 GOPATH 项目里 import 第三方包失败
比如 goapp deploy 报 can't find import，或 go build 提示包在 $GOPATH/src 外找不到。
- App Engine 要求依赖包必须放在
app.yaml所在目录的平级或子目录下，不能藏在src/里——即结构必须是：project/app.yaml+project/github.com/xxx/yyy - GOPATH 项目中，
go get下载的包默认进$GOPATH/src/github.com/xxx/yyy，但 import 语句必须写全路径："github.com/xxx/yyy"，不能只写"yyy" - MSYS2 等非标准环境要注意
GOROOT路径格式：必须用正斜杠或双反斜杠，C:\Go在 bash 里会被误解析
真正容易被忽略的是：GOPROXY 和 http_proxy 同时存在时的行为不可预测，而 IDE 的环境变量加载时机比终端晚得多——调通一个地方，不代表所有地方都通。先关代理、再设 GOPROXY、最后核对 IDE 配置，三步缺一不可。
