Windows 10 上用 PowerShell + Chocolatey 搭 Go 环境必须显式初始化 GOPATH、校验 go env -w 是否写入 profile、绕过 Windows Defender 误杀，否则首次 go mod init 会卡在 “go: cannot find main module” 或 “GOBIN not in PATH”；PowerShell 执行策略默认阻止 profile 加载导致环境变量失效，Chocolatey 不创建 src/bin/pkg 目录结构，VS Code 不自动识别 PowerShell 动态 PATH，且 Windows Defender 常静默隔离 dlv.exe/gopls.exe。
Windows 10 上用 PowerShell + Chocolatey 搭 Go 环境，不是“装完就能用”，而是必须显式初始化 GOPATH、校验 go env -w 是否真正写入 profile、并绕过 Windows Defender 对 go.exe 的误杀——否则你大概率会在首次 go mod init 时卡在 go: cannot find main module 或 GOBIN not in PATH。
PowerShell 执行策略导致 go env -w 失效
Chocolatey 安装的 Go 默认不修改 PowerShell 的 Execution Policy，而 go env -w 实际是往当前用户的 $PROFILE（如 $HOMEDocumentsPowerShellMicrosoft.PowerShell_profile.ps1）里追加变量赋值语句。如果该 profile 文件因策略被阻止加载，设置就白写了。
- 先运行
Get-ExecutionPolicy -Scope CurrentUser，如果不是RemoteSigned或Unrestricted，执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 再手动检查
$PROFILE是否存在且可写：Test-Path $PROFILE；不存在就New-Item -Path $PROFILE -Type File -Force -
go env -w GOPATH=$HOMEgo后，务必重启 PowerShell，然后运行go env GOPATH确认输出是你刚设的路径，而不是空或默认值
Chocolatey 安装 Go 后必须手动补全目录结构
Chocolatey 只装二进制和注册 GOROOT，但不会创建 GOPATH 下的标准子目录（src、bin、pkg），而 go install、go get 和部分 IDE 插件（如 VS Code 的 gopls）会依赖这些路径存在。
- 执行
mkdir $HOMEgosrc, $HOMEgoin, $HOMEgopkg - 把
$HOMEgoin加进PATH：在 PowerShell 中运行$env:PATH += ";$HOMEgoin"，再用go env -w GOBIN=$HOMEgoin持久化 - 验证：运行
go install golang.org/x/tools/cmd/gopls@latest，成功后检查$HOMEgoingopls.exe是否存在
VS Code 启动时找不到 gopls 或调试器崩溃
VS Code 的 Go 扩展默认从 PATH 查找 gopls 和 dlv，但它不读取 PowerShell profile 里的动态 PATH 修改——只认系统级或用户级环境变量，或者你在 VS Code 设置里显式指定路径。
立即学习“go语言免费学习笔记（深入）”；
- 不要依赖
go install后“自动生效”，打开 VS Code 前先关掉所有窗口，用Start-Process code -Verb RunAs以管理员权限启动一次，让它重新读取完整环境 - 在 VS Code 的
settings.json中强制指定工具路径："go.goplsPath": "$HOME\go\bin\gopls.exe"，注意双反斜杠转义 - 调试失败常见原因是
dlv版本与 Go 版本不匹配：Go 1.21+ 推荐用dlv@master，执行go install github.com/go-delve/delve/cmd/dlv@master
go mod init 报错 cannot find main module
这不是模块初始化失败，而是当前目录不在 GOPATH/src 下，且没显式指定模块路径——Go 1.16+ 默认启用模块模式，但不会自动推导根路径。
- 确保你在
$HOMEgosrcyournameprojectname这类路径下操作，而不是随便一个桌面文件夹 - 初始化时必须带域名或路径参数：
go mod init example.com/yourname/projectname，不能只写go mod init - 如果已建好项目但路径不对，删掉
go.mod，cd 到正确路径再重试；别试图用go env -w GOPATH=.临时覆盖，这会破坏整个工作区结构
最易被忽略的是 Windows Defender 的实时防护——它常把刚编译的 dlv.exe 或 gopls.exe 当作可疑程序静默隔离，导致 VS Code 调试器反复报 “failed to launch” 却不提示具体原因。每次 go install 后，记得去 Windows 安全中心 > 威胁历史里看有没有被隔离的文件，并添加排除路径：$HOMEgoin。
