“cannot find main module”错误主因是go未识别模块上下文，需确认go111module=on、项目不在$gopath/src内、路径无特殊字符，并确保goproxy=https://goproxy.cn,direct生效。
go mod init 失败提示“cannot find main module”
这不是代码问题，是 Go 根本没识别到你在模块上下文中运行。常见于项目在 $GOPATH/src 下、GO111MODULE 被设为 off，或当前目录压根没被当作工作根。
- 先执行
go env GO111MODULE，如果不是on，立刻运行go env -w GO111MODULE=on - 用
pwd确认当前路径，别在$GOPATH/src里操作——哪怕你只是想“试试”，Go 也会自动降级进 GOPATH 模式 - 删掉残留的
go.mod（如果内容为空或只有module一行），再跑go mod init example.com/myapp - 路径里含中文、空格、符号（如
my-project-v2!）也会让模块名解析失败，临时改纯英文下划线命名再试
go get 或 go mod download 卡住、超时、报 “dial tcp: i/o timeout”
99% 是 GOPROXY 没生效，或者 GOPROXY 值写错导致 fallback 到不可达的 proxy.golang.org。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 运行
go env GOPROXY，输出必须是类似https://goproxy.cn,direct——注意逗号后有空格会失效，direct必须小写且在末尾 - 国内推荐固定设为：
go env -w GOPROXY=https://goproxy.cn,direct；阿里云镜像可选https://mirrors.aliyun.com/goproxy/ - 私有仓库要跳过代理？加
go env -w GOPRIVATE=git.internal.company.com，多个用逗号分隔 - 改完立刻验证：
go mod download github.com/spf13/cobra，几秒内完成才算通；卡超过 10 秒就说明代理链断了
gopls 启动失败 / VS Code 提示 “package not found” / GoLand 红波浪线不消失
编辑器里的 LSP 异常，80% 源于 gopls 二进制缺失、PATH 找不到，或它启动时读错了环境变量。
- 手动安装：
go install golang.org/x/tools/gopls@latest；装完检查$GOPATH/bin/gopls是否存在 -
$GOPATH/bin必须在系统PATH中，否则 VS Code（尤其从桌面图标启动）根本看不到它 - VS Code 会继承 shell 环境，但 GoLand 不会自动 reload —— 改完
GOPROXY后，必须进Settings → Go → GOROOT → Reload - 如果
gopls启动日志里出现failed to load mod file，说明它当前打开的文件不在有效模块根目录下，关掉非项目根的 .go 文件再试
go version 显示对不上 / go env GOROOT 指向错误路径
GOROOT 被手动覆盖是最隐蔽的翻车点，尤其容易和 GOPATH 混淆。一旦设错，go build 可能静默使用旧版本 stdlib，引发奇怪的类型不匹配或函数不存在错误。
- 执行
go env GOROOT，输出应是 Go 安装根目录，比如/usr/local/go（macOS/Linux）或C:\Go（Windows） - 如果显示
/home/user/go或其他明显不是安装路径的值，立刻搜~/.zshrc、~/.bash_profile、~/.profile，删掉所有export GOROOT=...行 - Windows 用户注意：系统环境变量面板里设的
GOROOT优先级高于 shell 配置，务必检查“系统属性 → 高级 → 环境变量” - 改完重开终端，再跑
which go和go version对齐验证
GOPROXY 影响下载，GO111MODULE 决定是否启用模块，GOROOT 错了连 go mod 命令本身都可能行为异常。调试时别跳步，按 which go → go env GOROOT → go env GOPROXY → go mod download 这个顺序逐项敲命令验证，漏掉任何一环都可能让后续操作全盘失准。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
