go version报错或返回空，说明PATH未正确配置；Windows上需确认PowerShell或cmd中$env:PATH是否包含Go的bin路径（如C:\Go\bin），若缺失则用[Environment]::SetEnvironmentVariable追加用户级PATH并新开终端验证。
go version 命令报错或返回空，说明 PATH 没配对
Windows 上装完 Go 后，go version 找不到命令，不是安装失败，而是 PowerShell 或 cmd 没读到 C:\Go\bin（或你自定义的安装路径下的 bin）。官方 MSI 安装器虽声称“自动配置 PATH”，但实际只写入了系统环境变量，而当前用户 Shell 可能没刷新。
- 在 PowerShell 中执行
$env:PATH -split ";" | Select-String "Go"，确认路径是否真在其中 - 若没出现，手动用
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Go\bin", "User")追加（注意替换为你自己的Go安装路径） - 别改系统级 PATH——尤其在公司设备上，容易触发策略拦截；改当前用户的更安全
- 改完后必须新开一个 PowerShell 窗口，
cmd不会继承 PowerShell 的修改，反之亦然
go env -w GOPATH 失效，根源在 PowerShell Execution Policy
用 go env -w GOPATH=C:\Users\me\go 设置后，下次启动 PowerShell 仍显示默认值，不是命令没生效，而是 PowerShell 阻止了 profile 脚本加载——Go 的 env -w 实际是往 $HOME\go\env 写文件，但 PowerShell 默认不执行本地脚本，导致每次启动时无法自动加载这些设置。
- 先运行
Get-ExecutionPolicy，如果返回Restricted，就必然失效 - 临时放宽：以管理员身份运行 PowerShell，执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 再检查
$PROFILE是否存在，不存在就New-Item -Path $PROFILE -Type File -Force创建 - 在
$PROFILE末尾加一行：go env -u GOPATH（清空旧值），再加go env -w GOPATH="C:\Users\me\go" - 重启 PowerShell，
go env GOPATH应该稳定输出你设的路径
go mod init 报错 “go: cannot find main module”，其实是没进对目录
这个错误不是模块初始化失败，而是你在某个任意路径下直接敲了 go mod init example.com/hello，但 Go 要求当前工作目录必须是项目根，且不能位于 GOPATH/src 下（否则会降级为 GOPATH 模式）。
- 先确认当前路径：用
Get-Location或pwd，确保不在C:\Users\me\go\src里 - 新建干净目录，比如
mkdir C:\dev\hello && cd C:\dev\hello - 再运行
go mod init hello（模块名建议用小写字母+短横线，不用域名） - 如果已有
go.mod文件但内容异常，直接删掉重来——Go 不会覆盖已存在的go.mod - 顺手建个
main.go，内容必须含package main和func main()，否则go run .会报 “no Go files in current directory”
VS Code 调试器启动失败，launch.json 里没填 program 字段
很多教程复制的模板里 launch.json 缺少关键字段，导致点击调试按钮后提示 “Failed to launch: could not find program”。这不是插件没装好，而是配置不完整。
立即学习“go语言免费学习笔记（深入）”；
- 确保
.vscode/launch.json中configurations数组里有"program": "${workspaceFolder}/main.go" - 不要写成
"program": "./main.go"——VS Code 调试器不支持相对路径解析 - 如果项目含多个
main包（如 CLI 工具带多个可执行入口），每个都要单独配一个 configuration，并明确指定program - 首次调试前，先在终端跑一遍
go build -o hello.exe，确认能编译成功——调试器底层调用的仍是go run或go build
