最全的Golang语言环境搭建参考手册-Golang-PHP中文网

go version报错或显示旧版本说明系统未正确加载新go路径，需检查goroot是否指向/usr/local/go、path是否含$goroot/bin且顺序正确、shell配置文件是否source生效，windows和ide需单独配置。

最全的golang语言环境搭建参考手册

说明系统没走对 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

GoLand / VS Code 的 Go 插件默认不继承终端的 GOPROXY 或 GO111MODULE，所以即使你在 shell 里 go mod download 成功，编辑器仍可能报 cannot find package。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

确认项目根目录存在 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” 选项——它会干扰模块解析逻辑

根本原因通常是 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 runner 没正确初始化模块上下文，go.mod 里的 go 1.21 声明和实际运行的 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 进模块根目录再跑