go开发环境真正可用的标志是：go version能输出版本号、go mod init后能自动拉下依赖、编辑器中ctrl点击函数可跳转定义；其他配置均服务于这三件事。
Go 开发环境真正可用的标志只有三件事：执行 go version 能输出版本号、go mod init 后能自动拉下依赖、编辑器里按住 Ctrl 点击函数能跳转到定义。其他配置都是围绕这三件事服务的，别被“必须配 GOPATH”“一定要改 GOROOT”这类过时说法带偏。
go version 报“不是内部或外部命令”？关掉终端重开
Windows 用户装完 .msi 包后立刻在已打开的 CMD 或 PowerShell 里敲 go version，90% 会失败——这不是安装失败，是系统没读新环境变量。
- 必须关闭所有已打开的终端窗口，再全新启动一个
- 验证方式：运行
where go（Windows）或which go（macOS/Linux），应返回类似C:\Go\bin\go.exe的路径 - 如果仍找不到，手动检查系统环境变量
Path是否含C:\Go\bin（默认安装路径）或你自定义的bin目录 - macOS/Linux 用户若用
tar.gz解压安装，记得把/usr/local/go/bin加进PATH，并执行source ~/.zshrc生效
go run 成功但加了第三方库就报错？缺模块代理
Go 1.16+ 默认开启模块管理，但国内不配代理，go get 或 go mod download 基本必卡在 proxy.golang.org 上，错误常表现为超时、no matching versions 或空响应。
- 执行这三条命令（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org direct -
direct很关键：当镜像站没同步到最新包时，自动回源官方校验，避免因哈希不匹配中断 - 验证：运行
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux），输出应为https://goproxy.cn,direct - 别用
https://goproxy.io：该域名已停服，部分旧教程未更新
VS Code 提示“install tools”点完还是没补全？gopls 没装成
VS Code 的 Go 插件提示安装工具，本质是想装 gopls（语言服务器）。它一旦失败，跳转、补全、诊断全失效，但界面不会明确告诉你哪一步挂了。
- 先确保
GOPROXY已配好（见上一条），否则go install会卡死 - 在 VS Code 内置终端中手动运行：
go install golang.org/x/tools/gopls@latest - 安装成功后，
gopls二进制文件应在$GOPATH/bin/gopls（如C:\Users\xxx\go\bin\gopls.exe） - 重启 VS Code，或按
Ctrl+Shift+P→ 输入Developer: Reload Window强制重载 - 如果还报错，检查是否启用了
"go.useLanguageServer": true（默认开启，但工作区设置可能覆盖）
最易被忽略的点：模块初始化必须在项目根目录下执行 go mod init xxx，且目录名不能含空格或中文；gopls 启动依赖当前目录存在 go.mod，否则它会退化为无功能状态——看起来插件装了，其实什么都没做。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
