应执行go mod init初始化模块并确保在go.mod所在目录运行命令。该错误源于Go 1.16+默认启用Modules，要求go run或go build必须在含go.mod的目录下执行，常见于直接在桌面或空文件夹编写main.go后立即运行。
go: cannot find main module 错误怎么修
这不是 Go 安装失败，而是当前目录没被识别为模块根——Go 1.16+ 默认强制启用 modules，go run 或 go build 必须在有 go.mod 的目录下执行。
常见诱因：直接在桌面或空文件夹里写 main.go 就跑 go run main.go；或者用 VS Code 打开单个 .go 文件但没打开整个含 go.mod 的文件夹。
- 先确认当前路径下有没有
go.mod：运行ls go.mod（macOS/Linux）或dir go.mod（Windows） - 没有？立刻初始化：
go mod init example.com/hello（模块名可任意，不强制匹配文件夹名） - 如果已有
go.mod但报错，检查是否在子目录里执行命令——必须在go.mod所在目录或其子目录中运行 - 别用
go get初始化模块，它已废弃；go mod init是唯一正途
go env -w 设置后不生效的 PowerShell 坑
PowerShell 的 ExecutionPolicy 和 profile 加载机制会让 go env -w GOPROXY=https://goproxy.cn 看似成功，实则只写进当前会话，重启就丢。
根本原因：Go 的 env -w 写的是用户级环境变量，但 PowerShell 默认不从注册表或系统级配置自动加载，尤其在非管理员权限启动时。
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go env GOPROXY确认当前值；再开新 PowerShell 窗口重试，看是否归零 - 手动写入 PowerShell profile：
notepad $PROFILE，追加一行$env:GOPROXY = "https://goproxy.cn,direct" - 确保 profile 存在且可写：若
$PROFILE返回空，先执行mkdir -p (Split-Path $PROFILE)+New-Item -Path $PROFILE -ItemType File -Force - Chocolatey 安装的 Go 不会自动处理 profile，这点和 macOS 的
~/.zshrc逻辑完全不同
GOPATH 和 GOROOT 混淆导致 go install 失败
go install 生成的二进制默认放进 $GOPATH/bin，不是 $GOROOT/bin。很多人把两者路径设成同一目录，结果 go install 覆盖了 Go 自身工具（如 go、godoc），后续命令全挂。
典型症状：go version 正常，但 go install golang.org/x/tools/gopls@latest 报 access is denied 或生成的 gopls 运行时报 missing DLL。
-
GOROOT应严格指向 Go 安装目录（Windows 默认C:\Go，macOS 默认/usr/local/go），**不要修改** -
GOPATH推荐设为独立路径，比如$HOME/go（macOS/Linux）或$HOME\go（Windows），并确保$GOPATH/bin在PATH中靠前 - 验证方式：
go env GOROOT和go env GOPATH输出必须不同，且which gopls（macOS/Linux）或where gopls（Windows）应返回$GOPATH/bin\gopls - VS Code 的 Go 扩展依赖
gopls在PATH中，路径错会导致“no workspace detected”
macOS 上 Homebrew 安装 Go 后 GOROOT 不对
Homebrew 安装的 Go 默认不设 GOROOT 环境变量，而某些旧脚本或 IDE（如老版本 GoLand）会硬依赖它，导致 go build 找不到标准库。
现象：go version 正常，但 go build 报 cannot find package "fmt" 或类似错误。
- 查 Homebrew Go 实际路径：
brew --prefix go，输出类似/opt/homebrew/Cellar/go/1.22.6 - 手动导出
GOROOT：echo 'export GOROOT=$(brew --prefix go)/libexec' >> ~/.zshrc && source ~/.zshrc - 验证：
go env GOROOT应输出/opt/homebrew/Cellar/go/1.22.6/libexec（Apple Silicon）或/usr/local/Cellar/go/1.22.6/libexec（Intel） - 注意：官方 .pkg 安装自动设好
GOROOT，Homebrew 不会，这是设计差异，不是 bug
真正麻烦的从来不是安装步骤本身，而是那些不会报错、但让后续命令静默失效的路径和权限细节——比如 PowerShell profile 未初始化、GOROOT 被意外覆盖、或者 go.mod 被 IDE 自动删掉又没提示。
