go version报错或显示旧版本说明系统未正确加载新Go路径，需检查GOROOT是否指向/usr/local/go、PATH是否含$GOROOT/bin且顺序正确、shell配置文件是否source生效，Windows和IDE需单独配置。
go version 命令报错或显示旧版本
说明系统没走对 Go 安装路径，或者 shell 环境变量未生效。常见现象：go version 输出 go version go1.18.10 linux/amd64，但你明明装了 1.22.5。
- Linux/macOS：检查
$GOROOT是否指向正确目录（如/usr/local/go），并确认$PATH包含$GOROOT/bin；用which go看实际调用的是哪个二进制 - Windows：检查系统环境变量中
GOROOT和PATH是否都设对，尤其注意PATH里是否重复写了多个go\bin路径，导致优先加载旧版 - IDE（如 GoLand）不读系统环境变量：必须在 IDE 设置里手动填
GOROOT，不能依赖终端里的go命令结果 - Shell 配置文件（
~/.bashrc、~/.zshrc）改完后要source才生效；macOS Catalina+ 默认用 zsh，别只改 bash_profile
go mod download 失败但终端能通，IDE 里标红
GoLand / VS Code 的 Go 插件默认不继承终端的 GOPROXY 或 GO111MODULE，所以即使你在 shell 里 go mod download 成功，编辑器仍可能报 cannot find package。
- 确认项目根目录存在
go.mod文件，且第一行是module example.com/xxx，不是空文件或注释行 - GoLand 中 Settings > Go > Go Modules → 勾选
Enable Go modules integration，并手动填GOPROXY（如https://goproxy.cn,direct），不要留空 - VS Code 的
go.toolsEnvVars设置里显式加"GOPROXY": "https://goproxy.cn,direct" - 禁用 IDE 的 “Use GOPATH that is defined in system environment” 选项——它会干扰模块解析逻辑
LiteIDE / GoLand 调试时断点不命中
根本原因通常是 dlv（Delve）版本与 Go 版本不兼容，或构建参数没关掉优化。
- LiteIDE：必须在编译配置里把
BUILDARGS改成-gcflags "-N -l"，否则 Go 编译器做了内联和变量消除，调试器找不到源码映射 - GoLand：Settings > Go > Debugger > Delve → 选
Use built-in delve；如果选 Custom，确保dlv是用go install github.com/go-delve/delve/cmd/dlv@latest装的，不是系统包管理器装的老版本 - 运行配置里
Run kind必须是Package，且Package path填./或具体main包路径，填main.go文件路径会导致 dlv 启动失败 - Windows + WSL2 组合下，别在 GoLand 里直接调试 WSL 项目——路径映射和符号表容易错乱，建议纯 Windows 或纯 WSL2 环境
CI 构建中 go test 报错 “no required module provides package”
这不是代码问题，而是 CI runner 没正确初始化模块上下文，go.mod 里的 go 1.21 声明和实际运行的 Go 版本不一致。
立即学习“go语言免费学习笔记（深入）”；
- GitHub Actions：必须用
actions/setup-go@v5显式指定go-version，且版本号要和go.mod第一行的go声明严格一致（比如go 1.22就得配1.22.x） - GitLab CI：镜像用
golang:1.22-alpine这类带明确小版本的 tag，避免用golang:latest—— 它可能已升到 1.23，而你的go.mod还写着go 1.22 - 自建 runner：安装 Go 后执行
go env -w GO111MODULE=on，防止某些旧脚本或 Makefile 触发 GOPATH 模式 - 最隐蔽的坑：
go test ./...在模块外执行会 fallback 到 GOPATH 模式，务必 cd 进模块根目录再跑
