windows安装go后go version报“不是内部或外部命令”，根本原因是path未生效，需手动将c:\go\bin加入用户级path并重启终端验证。
因为多数人卡在了「默认路径没选对」「代理没开」「go env -w 写错变量名」这三处，而不是安装本身慢。
Windows 安装后 go version 报错：不是内部或外部命令
这是 PATH 没生效的典型表现。MSI 安装器虽然声称“自动配置环境变量”，但 Windows 的用户变量和系统变量常有冲突，尤其当你用过旧版 Go 或手动改过 PATH。
- 打开 PowerShell，直接运行：
$env:Path -split ";" | Select-String "Go"，看输出里有没有C:\Go\bin - 如果没有，手动加进去：
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Go\bin", "User") - 关掉所有终端再重开，
go version才会真正生效 —— 不要信“已重启资源管理器”这种操作，必须新开终端
Linux/macOS 解压后 go 命令找不到
根本原因不是没加 PATH，而是 GOROOT 和 PATH 顺序写反了，或者用了错误的 shell 配置文件。
- 确认你用的是哪个 shell：
echo $SHELL，zsh 用户改~/.zshrc，bash 用户改~/.bashrc，别混用 - 这两行必须一起出现，且
$GOROOT/bin必须在 PATH 前置位：export GOROOT=/usr/local/goexport PATH=$GOROOT/bin:$PATH - 执行
source ~/.zshrc后，再跑which go，输出应为/usr/local/go/bin/go；如果还是空，说明source没起作用，检查文件权限或是否拼错文件名
go mod download 卡住或超时
Go 1.16+ 默认启用模块，但国内不配代理就是裸连 proxy.golang.org，这个域名在国内基本不可达。
- 立刻执行：
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且支持私有模块） - 验证是否生效：
go env GOPROXY，输出必须是完整字符串，不能只显示https://goproxy.cn—— 少了,direct会导致私有仓库拉不到 - 如果公司内网有自建代理（如 Artifactory），把地址换成
https://your-artifactory.example.com/artifactory/go/，同样要保留,direct
VS Code 里 Ctrl+Click 跳转极慢或失败
这不是网络问题，而是 gopls 语言服务器没正确加载项目上下文，常见于没进模块根目录就打开文件夹。
- 确保你用 VS Code 打开的是包含
go.mod的最外层目录，不是某一层子包 - 按
Ctrl+Shift+P→ 输入Go: Install/Update Tools→ 全选，尤其是gopls和dlv，别漏掉 - 在项目根目录下执行一次
go mod tidy，让gopls有完整依赖视图；否则它会反复尝试解析缺失的 import，导致卡顿
真正拖慢搭建速度的，从来不是下载或解压，而是每一步缺乏即时反馈验证。每次改完环境变量、代理或配置，务必用对应命令当场验证输出，而不是凭感觉往下走。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
