go run报“cannot find main module”是因go modules未激活或缺少go.mod文件，需检查go111module是否为on、创建go.mod、正确设置gopath及path，并配置goproxy和cgo_enabled以适配构建与代理需求。
go version 输出正常但 go run 报错 “cannot find main module”
这不是 Go 没装好，而是模块模式（Go Modules）没激活或当前目录不在模块上下文中。Windows 上尤其容易因 PowerShell 启动时未加载 profile、或 go env -w 设置被绕过而失效。
- 先运行
go env GO111MODULE，输出必须是on或空（Go 1.16+ 默认开启），不是off - 如果为
off，执行go env -w GO111MODULE=on；注意：PowerShell 需以管理员身份运行才能写入系统级环境变量 - 检查当前目录是否有
go.mod文件——没有就运行go mod init example.com/myapp（模块名只是导入路径标识，无需真实存在） - 别依赖
GOPATH/src目录结构：现代项目可放在任意路径，只要根目录有go.mod就能识别为模块
Chocolatey 安装 Go 后 GOPATH 不自动创建、go install 命令找不到工具
Chocolatey 只装二进制，不初始化 Go 工作区，也不创建 %USERPROFILE%\go\bin 这类目录。你手动运行 go install 时，它默认往 $GOPATH/bin 写，但该路径可能根本不存在。
- 手动创建目录：
mkdir C:\Users\%USERNAME%\go\bin（PowerShell 中用New-Item -ItemType Directory -Path "$env:USERPROFILE\go\bin"） - 设置
GOPATH：go env -w GOPATH="$env:USERPROFILE\go"（注意用双引号包裹含空格路径） - 把
$GOPATH\bin加进PATH：$env:Path += ";$env:USERPROFILE\go\bin"，然后重启 PowerShell 或重新加载 profile - 验证：
go install golang.org/x/tools/cmd/goimports@latest成功后，goimports -v应能直接调用
VS Code 中 “Go: Install/Update Tools” 卡住或报 proxy timeout
这是模块代理（GOPROXY）没设对，或者 Windows Defender / 公司防火墙静默拦截了 go get 的 HTTPS 请求。
- 优先设国内可信代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示私有模块走直连） - 禁用
GOINSECURE（除非你真在内网用自签名 repo），避免混淆信任链 - 如果仍超时，临时关掉 Windows Defender 实时防护（仅测试用），或在企业网络中确认是否需配置
HTTP_PROXY/HTTPS_PROXY - VS Code 的 Go 扩展会读取
go env，改完后务必重启 VS Code 窗口，不要只 reload window
团队统一构建产物时 CGO_ENABLED=0 失效、Linux 二进制在容器里报 “no such file or directory”
这个错误表面是文件不存在，实际是动态链接失败：Go 默认启用 CGO，在 Windows/macOS 编译出的二进制依赖本地 libc，扔进 Alpine 容器就会挂。
- 交叉编译前必须显式关闭 CGO：
set CGO_ENABLED=0（PowerShell）或$env:CGO_ENABLED="0" - 再设目标平台：
$env:GOOS="linux"; $env:GOARCH="amd64" - 最后构建：
go build -ldflags="-s -w" -o ./dist/app ./cmd/app（-s -w减小体积、去除调试信息） - 验证产物是否静态链接：Linux 上用
file dist/app，输出含statically linked才算成功
go env -w 的作用域冲突——它写的是用户级环境变量，但某些终端启动方式（比如从 VS Code 终端直接开 PowerShell）可能不加载 $PROFILE，导致 go env 显示正确，实际命令却读不到。建议所有成员在首次配置后，手动运行一次 go env | Select-String "GOPATH\|GOROOT\|GOBIN" 并比对输出与 $env:GOPATH 是否一致。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
