Go原生插件机制依赖编译器内置的runtime和cgo调用dlopen/dlsym，但存在编译加载约束多、文档缺失、排错困难等问题；需深入标准库源码定位典型问题。
go mod download卡住或报proxy.golang.org: no such host
这不是环境没装好，而是 GOPROXY 没设——Go 1.13+ 默认直连 proxy.golang.org，国内基本不通。不配代理，go mod download、go install、IDE 启动 gopls 全都会卡在 DNS 或 TLS 握手阶段。
必须显式设置代理：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且支持私有模块） - 或
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 末尾的
,direct很关键：允许你公司内网的git.company.com/my/internal这类模块跳过代理直连 - 别用
https://goproxy.io——该域名已停服，设了等于没设
验证是否生效：go env GOPROXY 输出应为刚设的地址；再试 go mod download github.com/spf13/cobra，几秒内完成才算真正通了。
GO111MODULE=off 导致 go mod init 失效
即使目录下有 go.mod，Go 也可能完全忽略它——因为 GO111MODULE 被关掉了。老项目迁移或 CI 环境里常默认为 off，这时 go mod init 会静默失败，go build 则报 cannot find module。
立即学习“go语言免费学习笔记（深入）”；
强制启用模块模式：
- 查当前值：
go env GO111MODULE - 设为
on：go env -w GO111MODULE=on - 如果只是临时调试，也可以加前缀运行：
GO111MODULE=on go mod init example.com/foo
注意：设完后不用重启终端，但旧 shell 里已启动的 gopls 进程需手动重启（VS Code 可按 Ctrl+Shift+P → “Go: Restart Language Server”）。
GOROOT 指向错误导致标准库找不到
go build 报 cannot find package "fmt" 或其他标准库包，不是代码写错了，是 GOROOT 指向了一个空目录、项目根目录，或者损坏的 Go 安装路径。
检查并修正：
- 运行
go env GOROOT，看输出是否是你解压 Go 的真实路径（如/usr/local/go） - 确认该路径下存在
src/fmt和pkg/tool目录：ls -l $GOROOT/src/fmt - 如果
GOROOT是空或明显错（比如$HOME/go），删掉错误声明：go env -u GOROOT - 不要手动
export GOROOT=...——除非你解压到了非标路径且必须指定；多数情况让 Go 自动推导更安全
真正容易被忽略的是：不同 shell（zsh/bash/fish）读取的配置文件不同，~/.bashrc 里写的 export GOROOT 在 zsh 终端里完全不生效；容器或 GitHub Actions 中，go 命令存在，但 GOPROXY 没继承，构建照样卡在依赖下载。
