go version报错说明path未正确配置，需手动将go的bin目录（如c:\program files\go\bin）加入系统path并重启powershell；go mod init失败因未在项目目录执行；go get卡住需配置goproxy并关闭gosumdb；vs code调试失败常因dlv未安装或gobin未入path。
go version 命令报错：command not found 或不是内部或外部命令
说明 Go 的 bin 目录没进 PATH，PowerShell 或 cmd 都不会认得 go 这个命令。Windows 上 Chocolatey 默认装在 C:\Program Files\Go\bin，但这个路径不会自动加进系统 PATH——尤其 PowerShell 启动时可能加载的是旧 profile。
- 先确认安装位置：
choco list go查版本，再看C:\Program Files\Go\bin是否真实存在go.exe - 手动把
C:\Program Files\Go\bin加进「系统环境变量」的PATH（不是用户变量），重启 PowerShell - 别用
go env -w GOPATH=...先试——如果go命令都找不到，go env也执行不了 - 验证：新开一个 PowerShell，直接输
go version，必须有输出才继续
go mod init 失败：go: cannot find main module, use 'go mod init' to create one
这不是环境没装好，而是你在任意目录下直接敲 go run main.go 导致的。Go 1.16+ 默认启用模块模式，要求当前路径属于某个 go.mod 所在模块的子目录，否则拒绝识别。
- 不要在桌面、Downloads 或根目录下写第一个
main.go——这些地方没有go.mod，Go 不认 - 新建项目目录，比如
C:\dev\hello，然后进该目录执行：go mod init hello -
go mod init后会生成go.mod文件，内容含模块名（如module hello），后续所有go run/go build才能正常解析依赖 - 模块名不一定要和目录名一致，但建议保持一致，避免后期
import路径出错
go get 一直卡住或超时：proxy 没生效或被 Windows Defender 拦截
国内直连 proxy.golang.org 基本不可用，而 Chocolatey 安装的 Go 默认不设代理；更隐蔽的问题是 Windows Defender 有时会静默拦截 go.exe 的网络请求，表现为 go get 卡在 “Fetching” 无响应。
- 立刻设置代理：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 同时关掉模块验证（开发阶段）：
go env -w GOSUMDB=off，避免 checksum 校验失败中断 - 检查 Defender：打开「Windows 安全中心」→「病毒和威胁防护」→「管理设置」→ 关闭「实时保护」5 秒，再试一次
go get fmt - 如果仍卡，用
curl -v https://mirrors.aliyun.com/goproxy/测试代理地址是否可达
VS Code 调试器启动失败：dlv 未安装或架构不匹配
Go 扩展默认用 dlv（Delve）调试，但它不是 Go 自带的，需单独装；而且 Windows 上 x86_64 和 ARM64 版本不能混用，装错就报 exec format error。
- 先运行：
go install github.com/go-delve/delve/cmd/dlv@latest - 装完后检查：
dlv version—— 如果报错说找不到命令，说明GOBIN没进PATH，或者GOBIN路径里没生成dlv.exe - 确认
GOBIN路径：go env GOBIN，通常为C:\Users\<username>\go\bin</username>，确保该路径已加入PATH - VS Code 中调试前，务必在项目根目录下有
go.mod，且 launch.json 的mode设为auto或exec，别硬写test
PATH、go.mod、GOPROXY 这三者有没有在同一个上下文里对齐——PowerShell 启动一次、改一次环境变量、开一个新终端，这三件事必须同步做，缺一不可。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
