go version报错或无输出说明PATH未正确配置，需确认%GOROOT%\bin（如C:\Program Files\Go\bin）已加入系统PATH并重启命令行，再用where go验证路径是否存在。
go version 命令报错或无输出
说明：这不是 Go 没装好，就是 PATH 没配对。Windows 上常见原因是 go.exe 不在系统 PATH 里，或者安装时勾选了“Add to PATH”但没生效（尤其 MSI 安装后未重启终端）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 打开新命令提示符（不是旧窗口），运行
where go，看是否返回路径；若无结果，说明 PATH 缺失 - 手动检查
%GOROOT%\bin（如C:\Program Files\Go\bin）是否已加入系统环境变量 PATH - 别依赖 GUI 安装器自动配置——它有时只改当前用户 PATH，而 CMD 默认读系统 PATH；可改用 ZIP 包解压 + 手动设
GOROOT和 PATH - 验证时用
go env GOROOT和go env GOPATH确认两个变量值是否合理，避免空值或路径含空格未引号包裹
VS Code 中 gopls 启动失败或卡在 “Loading…”
说明：gopls 是 Go 官方语言服务器，VS Code 的智能提示、跳转、诊断全靠它。启动失败通常因模块初始化不完整、代理/网络问题，或 go.mod 路径解析异常。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保项目根目录下有
go.mod文件；没有就执行go mod init example.com/myapp（模块名不必真实，但不能是.或空） - 关闭 VS Code，删掉项目下的
go.sum和vendor/（如有），再重开，让gopls重新索引 - 检查 Go 版本是否 ≥ 1.18（
goplsv0.14+ 要求），旧版 Go 可能触发静默崩溃 - 若公司内网或国内环境，设置 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct
go fmt / goimports 不生效或格式化后 import 顺序混乱
说明：VS Code 默认用 gofmt，但很多人想要更智能的导入管理（自动增删包、按字母分组）。如果保存后没整理 import，大概率是工具链没装或配置没对上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go install golang.org/x/tools/cmd/goimports@latest（注意不是go get，后者在 Go 1.17+ 已弃用） - 在 VS Code 设置中确认
go.formatTool设为"goimports"，且该设置作用域是“工作区”而非仅“用户”，否则新建文件不生效 - 如果仍无效，打开命令面板（Ctrl+Shift+P），运行
Go: Install/Update Tools，勾选goimports单独重装 -
goimports不处理标准库和本地包的排序逻辑——它只管第三方包是否缺失/冗余；标准库总在最前，本地包总在最后，这是硬编码行为，不是 bug
IntelliJ IDEA 中 Go SDK 识别失败或无法加载 module
说明：IntelliJ 对 Go 支持依赖插件与 SDK 绑定，但它的 SDK 配置比 VS Code 更隐晦——它不读系统 GOROOT，而是要求你手动指定 Go 安装目录的 bin 上一级（即包含 src、pkg 的那个目录）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 打开
File → Project Structure → SDKs，点击 + →Go SDK，然后选择 Go 安装根目录（例如C:\Program Files\Go），**不是**C:\Program Files\Go\bin - 确认项目
go.mod文件存在，且右键该文件 →Reload project，否则 IDEA 不会启用 module-aware 模式 - 若提示 “Module not loaded”，检查
Settings → Languages & Frameworks → Go → Go Modules是否勾选Enable Go modules integration - 避免混用
GOPATH模式项目和 module 模式项目——IDEA 在同一 workspace 下对两者支持不一致，容易出现索引错乱
真正卡住人的地方不在“装没装”，而在“哪个环节读的是哪个路径、哪个版本、哪个作用域”。比如 goimports 装在用户 home 下，但 VS Code 启动时用的是系统 shell 的 PATH，而 shell 又可能没加载 profile；又比如 IntelliJ 读的是自己缓存的 SDK 元数据，改完环境变量也不刷新，必须手动 reload。这些细节不显眼，但一漏就整晚白调。
