go version报错“不是内部或外部命令”根本原因是path未包含%goroot%\bin，需手动将go的bin目录（如c:\go\bin）加入系统path并重启命令行。
go version 命令没反应？先确认 GOROOT 和 PATH
安装完 .msi 包后，go version 报 'go' is not recognized 是最常见卡点。这不是安装失败，而是系统没找到 go.exe。
Windows 默认会把 GOROOT 设为 C:\Program Files\Go 或 C:\Go，但安装程序有时不会自动把 %GOROOT%\bin 加进 PATH（尤其在非管理员权限下安装时）。
- 手动检查：
echo %GOROOT%看输出是否合理；再运行echo %PATH%，确认里面包含类似C:\Go\bin的路径 - 若缺失：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里编辑
PATH，新增一行：%GOROOT%\bin - 改完必须新开一个 CMD/PowerShell 窗口——旧窗口的环境变量不会自动刷新
go mod init 报错 “cannot determine module path”？别硬塞 GOPATH
用 go mod init 初始化模块时，如果当前目录在 %GOPATH%\src 下，且路径名不合法（比如含空格、中文、以数字开头），Go 会拒绝推导模块名，直接报错。
这不是 bug，是 Go Module 模式有意为之的设计：它不再强依赖 GOPATH，反而鼓励你把项目放在任意位置（桌面、文档夹、D 盘根目录都行）。
- 正确做法：新建一个干净路径，比如
D:\hello-go，cd 进去，再执行go mod init hello-go - 错误做法：非要把项目建在
%GOPATH%\src\my-project里，还起名叫123test—— Go 会拒绝生成go.mod - 验证是否进入 Module 模式：
go env GO111MODULE应该返回on（Go 1.16+ 默认开启，不用额外设）
go run main.go 提示 “cannot find module providing package fmt”？代理没生效
这个错误不是缺 fmt（它是标准库，永远存在），而是 Go 在首次构建时试图拉取模块元数据，却因网络问题卡在 proxy 查询阶段，最终误报。
国内用户几乎必踩：默认 GOPROXY=https://proxy.golang.org,direct 在大陆无法访问，导致 go run 卡住几秒后失败。
- 立刻设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否写入：
go env GOPROXY应输出https://goproxy.cn,direct - 注意逗号后不能有空格，
direct必须小写且紧贴逗号，否则 Go 会忽略整个配置 - 改完无需重启终端，下次
go run就会走镜像源，通常 1 秒内完成
VS Code 里 Ctrl+Click 跳不到定义？Go 扩展没装对
VS Code 官方 Go 扩展（由 Go Team 维护）依赖本地 gopls 语言服务器。如果只装了扩展但没装 gopls，或者装了旧版，就会出现跳转失效、无补全、保存不格式化等问题。
这不是配置问题，是工具链没拉齐。
- 打开 VS Code 终端（
Ctrl+`），运行：go install golang.org/x/tools/gopls@latest - 安装完成后，VS Code 右下角可能弹提示“Detected a new gopls version”，点“Restart”
- 确认
gopls已就位：gopls version应输出类似gopls v0.15.2 - 别用第三方“Go for Visual Studio Code”等非官方插件——它们早已过时，和现代 Go Module 不兼容
go run main.go 的关键，从来不是“装了没”，而是“路径对不对、代理通不通、工具链齐不齐”。这三个环节中任一出错，都会让第一行代码卡在终端里动不了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
