PowerShell执行策略限制导致go env -w失效，GOPATH目录未手动创建（src/bin/pkg）及路径上下文错位是go mod init和go run失败主因；需先调高执行策略、建全目录结构、确保$GOPATH/bin加入PATH，并显式启用GO111MODULE=on。
直接上结论：在 Windows 10 上用 PowerShell + Chocolatey 搭 Go 环境，go env -w 设置的变量大概率失效，GOPATH 不手动建目录就跑不起来 go mod init，go run 报 cannot find main module 是路径和模块初始化双重错位导致的——不是环境没装好，是环境“看起来好了”，其实没活过来。
PowerShell 执行策略拦住 go env -w
Chocolatey 装完 Go 后，很多人习惯立刻执行 go env -w GOPATH=$HOMEgo，但 PowerShell 默认策略是 Restricted，它会静默拒绝执行任何写环境变量的脚本类操作。你敲完命令没报错，也不提示失败，但 go env 里还是空的。
- 先运行
Get-ExecutionPolicy确认当前策略，不是RemoteSigned或AllSigned就得改 - 用管理员身份打开 PowerShell，执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 改完别急着关窗口，立刻验证：
go env -w GOPATH="$HOMEgo"→ 再go env GOPATH看输出是否是你设的路径 - 别用
$env:GOPATH = "..."这种临时赋值，它只在当前会话生效，关了 PowerShell 就丢
GOPATH 目录结构必须手动创建
Go 1.16+ 默认启用模块模式，GOPATH 不再强制，但它仍是 go get、go install 和 VS Code 插件查找依赖的默认落点。Chocolatey 不帮你建 src/bin/pkg 这三层目录，而 VS Code 的 Go 扩展一启动就扫 $GOPATH/src，找不到就报红。
- 执行
mkdir $HOMEgosrc, $HOMEgoin, $HOMEgopkg（注意逗号分隔，PowerShell 支持批量创建） - 检查
$HOMEgoin是否已加入PATH：运行$env:PATH -split ";" | Select-String "go\bin"，没结果就得补 -
go install出的二进制（比如dlv）一定落在$GOPATH/bin，不是$GOBIN——除非你显式设了GOBIN，否则它被忽略
go mod init 失败的真实原因
新建项目文件夹后直接 go mod init myapp 报 cannot find main module，90% 是因为当前路径不在 $GOPATH/src 下，且没开 Git 仓库或没设 GO111MODULE=on。模块初始化不是“随便在哪都能起”，它依赖路径上下文。
立即学习“go语言免费学习笔记（深入）”；
- 要么把项目建在
$GOPATH/src/github.com/yourname/myapp下（传统方式，VS Code 最认） - 要么在项目根目录执行
$env:GO111MODULE="on"（PowerShell），再go mod init myapp - 别信“模块模式不用
GOPATH”的简化说法——go list -m、go mod graph等命令仍会查GOPATH/pkg/mod缓存，这个目录不存在就会卡住 - 首次
go mod download前，确保$GOPATH/pkg/mod可写，Windows Defender 有时会锁死该路径
VS Code 调试器 dlv 安装位置陷阱
go install github.com/go-delve/delve/cmd/dlv@latest 看似简单，但它默认装到 $GOPATH/bin，而 VS Code 的 Go 扩展默认只从 $GOBIN 或 PATH 里找 dlv。如果 GOBIN 没设，又没把 $GOPATH/bin 加进 PATH，调试器就启动失败，报 dlv not found。
- 执行前先确认
$env:GOBIN输出为空，那就别设它，老老实实走$GOPATH/bin - 安装完立刻运行
Get-Command dlv，看是否返回可执行路径；没返回就说明 PATH 没包含它 - VS Code 的
settings.json里加一行："go.toolsEnvVars": { "GOPATH": "$HOME\go" }，强制插件按你的路径找工具 - 别用 Chocolatey 装
delve包——它装的是旧版，且路径和 Go 工具链不一致
最常被跳过的环节是 $GOPATH/pkg/mod 目录权限和 Windows Defender 干预，它不报错，只让 go mod tidy 卡在 99%，等三分钟自动超时。动手前先右键该目录 → 属性 → 安全 → 编辑 → 给当前用户“完全控制”权限，比反复重装 Go 实在得多。
