go命令找不到需先检查path是否包含c:\go\bin并新开终端验证；goproxy必须配置为https://goproxy.cn,direct且同步设置ide；vs code需手动安装gopls等工具；goroot必须正确设置，gopath仅旧式项目需要。
go 命令找不到？先盯死 PATH 和安装路径
Windows 上装完 Go 却在 cmd 或 PowerShell 里敲 go version 报错“不是内部或外部命令”，90% 是 PATH 没生效，而不是没装成功。
MSI 安装器勾选了 “Add Go to PATH” 也不保险：它只写入当前用户的环境变量，且某些终端（比如以管理员身份启动的 PowerShell）可能读不到。更麻烦的是，如果之前手动改过 PATH 或装过其他版本，路径可能冲突。
- 打开命令行，运行
echo %PATH%，确认输出里包含C:\Go\bin（默认安装路径） - 如果没看到，别急着重装——右键“此电脑” → “属性” → “高级系统设置” → “环境变量”，在“用户变量”或“系统变量”的
PATH里手动加一行：C:\Go\bin - 改完后，**必须新开一个命令行窗口**再测试，旧窗口不会自动刷新环境变量
- 验证用
where go（Windows）或which go（WSL/macOS），它会显示实际被调用的可执行文件路径，比go version更早暴露路径问题
GOPROXY 不配，go mod download 就卡死
国内用户不设代理，go mod download 或 go get 基本必超时。这不是网络差，是 go 默认直连 proxy.golang.org，而这个域名在国内解析和连接都极不稳定。
别信“等一会儿就好”，也别靠反复重试——直接配代理才是正解。而且要配两处：命令行环境变量 + IDE 内置配置，缺一不可。
- 命令行配：运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐 goproxy.cn，稳定、支持校验） - VS Code 配：打开设置（Ctrl+,），搜
go.toolsEnvVars，添加键值对："GOPROXY": "https://goproxy.cn,direct" - Goland 配：Preferences → Go → Go Modules → Environment，填入同上内容
- 顺手关掉校验（避免私有模块失败）：
go env -w GOSUMDB=off，生产环境上线前再按需开
VS Code 插件报红、补全失效？工具链没装齐
装完 Go SDK 和 VS Code 的 Go 插件，不代表开发环境就 ready 了。插件依赖的底层工具（如 gopls、dlv）没装，就会 import 报红、跳转失效、断点不触发——但 go run 照样能跑，这最容易让人误判问题根源。
别点插件弹出的“Install All Tools”就完事，那个按钮经常静默失败，尤其在网络受限时。
- 手动触发安装：Ctrl+Shift+P → 输入
Go: Install/Update Tools→ 全选，尤其是gopls（语言服务器）、dlv（调试器）、goimports（格式化） - 观察输出面板（Output → Tasks），看有没有
go install失败日志，常见错误是cannot find module providing package，说明GOPROXY没生效 - 如果卡在某个工具，比如
gopls，直接命令行跑：go install golang.org/x/tools/gopls@latest，失败时看具体报错 - 装完重启 VS Code，别只重载窗口——重载后插件有时仍用旧缓存
GOROOT 和 GOPATH 还用不用设？看 Go 版本和项目结构
Go 1.16+ 默认启用 modules，GOPATH 对项目构建已非必需，但 GOROOT 必须正确，否则 IDE 找不到 SDK，go 命令本身也可能异常。
很多人还在纠结要不要设 GOPATH，其实关键看你怎么组织代码：
-
GOROOT：必须指向 Go 安装根目录（如C:\Go），Windows MSI 通常自动设好；手动解压安装的，需手动go env -w GOROOT=C:\Go - 纯 module 项目（有
go.mod）：无需GOPATH，所有依赖走$GOPATH/pkg/mod缓存，但你完全不用管这个路径 - 老式 GOPATH 工作区项目（没
go.mod）：必须设GOPATH，且源码得放在$GOPATH/src下，否则go build找不到包 - VS Code/Goland 里新建项目时，如果选“Module aware”，就别碰
GOPATH；如果选“GOPATH mode”，IDE 会强制要求你填GOPATH
go env -w 立即生效，但 VS Code 启动时只读一次，Goland 甚至要重启整个 IDE 才认新变量。配完别急着写代码，先关掉所有编辑器窗口，从开始菜单重新打开。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
