根本原因是path中存在多个go可执行文件路径，系统优先调用旧版本；需运行which go或where go确认实际路径，清理path中旧go的bin目录，并验证go env goroot与当前二进制匹配。

go version 显示旧版本，但刚装了新 Go

根本原因是 PATH 中存在多个 go 可执行文件路径，系统优先找到了旧版本的 go.exe（Windows）或 go（macOS/Linux）。常见于手动解压覆盖安装、多版本共存未清理、或 MSI 安装后残留旧 bin 目录。

• 运行 where go（Windows）或 which go（macOS/Linux）确认实际调用的是哪个路径
• 检查 PATH 环境变量，删除所有指向旧 Go 安装目录（如 C:\Go\bin、/usr/local/go/bin 以外的其他 bin）的条目
• Windows 用户特别注意：控制面板卸载后，仍可能残留 C:\Program Files\Go\bin 或用户目录下的 ~/go/bin，需手动删干净
• 验证 GOROOT 是否与当前 go 二进制匹配：执行 go env GOROOT，输出路径下必须存在 src、pkg、bin 三个子目录

go build 报 “object is [X] expected [Y]”

这是典型的工具链与标准库版本不一致错误，不是代码问题，而是环境错配。编译器（如 compile）来自一个 Go 版本，而它试图加载的 fmt.a 等包来自另一个版本。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 立即停止使用 replace 或 go install 修改 GOROOT 下的任何内容
• 执行 go clean -cache -modcache -i 彻底清空构建缓存和模块缓存
• 删除项目根目录下的 go.sum 和 vendor/（如有），再运行 go mod tidy
• 若用 WSL，确认 Windows 和 WSL 的 Go 安装完全隔离——不要在 WSL 中挂载 Windows 的 C:\Go

go get 或 go mod download 卡住或超时

国内用户几乎必遇的问题，本质是默认代理 proxy.golang.org 不可达，且 GO111MODULE 未启用导致 fallback 到 GOPATH 模式失败。

• 确认 GO111MODULE=on 已生效：运行 go env GO111MODULE，输出必须是 on
• 设置可靠代理：go env -w GOPROXY=https://goproxy.cn,direct（七牛）或 https://mirrors.aliyun.com/goproxy/（阿里云）
• 私有仓库必须跳过代理：例如公司 GitLab，执行 go env -w GOPRIVATE=git.company.com
• 临时调试可用 go mod download -x 查看具体卡在哪一步（会打印完整 fetch 命令和 URL）

VS Code 提示 “package not found”，但 go run 正常

编辑器 LSP（gopls）找不到包，和命令行工具链无关，纯属编辑器配置或 gopls 自身状态问题。

• 先运行 go install golang.org/x/tools/gopls@latest 确保最新版已安装到 $GOPATH/bin
• VS Code 设置中检查 "go.goroot" 是否为空——留空即可自动识别；若填了，必须和 go env GOROOT 严格一致
• 禁用所有非官方 Go 插件（尤其 go-outline、go-plus），只保留 gopls 官方插件
• 按 Ctrl+Shift+P → 输入 “Developer: Toggle Developer Tools”，看 Console 是否报 gopls panic 或 timeout —— 有则重启 VS Code 并重载窗口

Golang 环境问题大多不是“不会配”，而是“配了但没配对”。PATH、GOROOT、GOBIN 三者必须指向同一套安装，且不能混用不同来源的二进制（比如 Homebrew 装的 Go + 手动解压的 gopls）。每次怀疑环境异常，优先用 where go / which go 和 go env 交叉验证，比重装更省时间。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！