答案是PATH未正确配置或存在多版本冲突。需先which go确认路径，再将新版go/bin置于PATH前端（如export PATH="/usr/local/go/bin:$PATH"），source配置文件后验证；若用ASDF/GVM等工具，则必须确保~/.asdf/shims等shim路径在PATH最前。
go version 命令报错或显示旧版本怎么办
安装后 go version 不生效、显示老版本（比如 go1.16），大概率是 PATH 没刷进当前 shell，或者系统里残留多个 Go 安装路径。Mac/Linux 用户常漏掉 source ~/.zshrc 或 source ~/.bash_profile；Windows 用户则容易在「系统变量」和「用户变量」里重复配置，导致优先级混乱。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先运行
which go（Mac/Linux）或where go（Windows），确认实际调用的是哪个路径 - 对比输出路径和你解压/安装的 Go 目录是否一致；不一致就删掉旧路径，只保留新版本的
/usr/local/go/bin（Linux/macOS）或C:\Go\bin（Windows） - Mac 上若用 Homebrew 安装，别再手动加
/usr/local/bin到 PATH——Homebrew 会自动处理，额外添加反而可能冲突
go mod init 后 go.sum 文件为空或依赖拉不下来
执行 go mod init example.com/myapp 后，go.sum 为空、后续 go run main.go 报 cannot find module，基本是 GOPROXY 没设好。国内默认直连 proxy.golang.org 会被拦截，且 Go 1.13+ 默认启用代理，但没显式配置时可能 fallback 到 direct，失败后也不报错，只静默跳过。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 立即设置国内代理：
go env -w GOPROXY=https://proxy.golang.com.cn,direct（推荐）或https://goproxy.cn - 顺手关掉私有模块校验：
go env -w GOSUMDB=off（仅开发阶段；生产环境应保留sum.golang.org） - 如果公司内网有私有仓库，需额外配置
GOPRIVATE，例如：go env -w GOPRIVATE=git.internal.company.com/*
GoLand 中 GOPATH 和 Go Modules 冲突导致代码无法识别
GoLand 提示 “Unresolved reference”、“Cannot resolve symbol”，但命令行 go run 正常，说明 IDE 没正确识别 Module 模式。常见于老项目迁移或误启用了 GOPATH mode——GoLand 2022.3+ 默认优先走 Modules，但若项目根目录没 go.mod，或设置了错误的 SDK 路径，它就会退回到 GOPATH 模式。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查项目根目录是否存在
go.mod；没有就补一个：go mod init your-module-name - 在 GoLand 中打开
File > Settings > Go > Go Modules，确认勾选了Enable Go modules integration - 点击
File > Close Project，再重新用Open（不是Open Folder）打开项目根目录——这是触发 Module 模式识别的关键动作 - 避免手动设置
GOPATH：现代 Go 项目不需要它；GoLand 会自动从go env GOPATH读取，但不应干预
main.go 编译通过但运行时报 panic: runtime error: invalid memory address
这种 panic 多半不是环境问题，而是代码规范缺失引发的隐性陷阱。比如未初始化 map 就直接赋值、nil channel 上 select、或 defer 里调用未定义方法。环境搭建阶段看似“跑通”，但这类错误会在真实逻辑中突然爆发，且 stack trace 很难定位。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 初始化所有复合类型：map 必须用
m := make(map[string]int)，不能只写var m map[string]int - 用
go vet扫描基础问题：go vet ./...—— 它能发现未使用的变量、死代码、printf 参数不匹配等 - 开启静态检查：在 GoLand 中启用
Settings > Editor > Inspections > Go > Go Vet，实时标出潜在 panic 点 - 别跳过
go fmt：格式不统一会导致团队协作时 diff 混乱，间接掩盖真正的问题
