go version报错或显示旧版本是path未生效所致，需确认shell类型并正确编辑配置文件（如zsh改~/.zshrc）、执行source重载，再用echo $path验证是否含go二进制路径。
go version 命令报错或显示旧版本，PATH 配置没生效
常见现象是终端里敲 go version 提示 command not found，或者显示的是系统残留的旧版（比如 macOS 自带的 go1.16），而不是你刚装的新版。这不是安装失败，而是 shell 没加载到你新配的 PATH。
Linux/macOS 用户最容易踩的坑：改了 ~/.bashrc 却用 zsh 终端，或者改了 ~/.zshrc 却忘了 source。验证方式不是重启终端，而是直接运行：echo $PATH，确认输出里包含 /usr/local/go/bin 或你实际解压的 go 二进制路径。
- macOS Catalina 及之后默认用
zsh，应编辑~/.zshrc；旧系统用bash则改~/.bash_profile - VS Code 内置终端可能不读取 shell 配置文件，需在设置里勾选
terminal.integrated.inheritEnv，或手动重启 VS Code - Windows 用户若用 PowerShell，
Path环境变量修改后需重启所有 PowerShell 窗口，CMD 不会自动同步
GO111MODULE 默认关闭？别信文档，检查真实状态
Go 1.16+ 起 GO111MODULE 默认为 on，但很多老项目或 Docker 镜像仍基于旧基础镜像（如 golang:1.15），导致 go mod 命令不触发、依赖不下载、go.sum 不生成——你以为是网络问题，其实是模块模式根本没开。
运行 go env GO111MODULE 查看真实值。如果输出 off，立刻执行：go env -w GO111MODULE=on。国内用户务必顺手加上代理：go env -w GOPROXY=https://goproxy.cn,direct。
- 不要在项目里靠
export GO111MODULE=on临时启用——它只对当前 shell 有效，CI/CD 或 IDE 启动的进程不会继承 -
go env -w是写入$HOME/go/env的全局配置，比 shell 配置更可靠；但注意它不能被go clean -modcache清掉 - 如果项目根目录有
go.mod文件却仍提示no required module provides package，八成是模块模式关着，先查GO111MODULE
GOROOT 和 GOPATH 还需要手动设吗？90% 场景下不用
现代 Go（1.13+）已能自动推导 GOROOT：只要 go 命令本身能运行，GOROOT 就已正确。强行设 GOROOT 反而容易出错（比如指向错误目录导致标准库找不到）。GOPATH 同理——go mod 项目完全不依赖它，go build 和 go run 也不再强制要求代码放在 $GOPATH/src 下。
唯一需要显式配置 GOPATH 的场景，是你要用 go install 安装命令行工具（如 gopls、stringer），它们默认装到 $GOPATH/bin。此时只需确保该目录在 PATH 中，GOPATH 值本身可保持默认（$HOME/go）。
- VS Code 的 Go 扩展若提示
goplsnot found，大概率是$GOPATH/bin没进PATH，而非GOPATH本身没设 - 多版本共存时（如用
gvm或go install切换），GOROOT会动态变，手动固定反而破坏切换逻辑 - CI 流水线里避免写死
GOROOT，用which go反推更稳妥
VS Code Go 扩展启动卡住或无法跳转定义
这不是插件坏了，而是 gopls（Go Language Server）没起来或卡在依赖解析上。典型表现：打开项目后左下角一直显示 “Running ‘gopls’…”、Ctrl+Click 无效、没有自动补全。
先检查 gopls 是否存在：which gopls。如果没输出，运行 go install golang.org/x/tools/gopls@latest 安装。再打开 VS Code 设置，搜 go.gopls，确认 go.useLanguageServer 是 true。
- 大型单体项目首次启动
gopls可能卡 2–5 分钟，期间不要关掉它——它在构建缓存，后续就快了 - 若持续卡住，删掉
~/Library/Caches/gopls（macOS）或$HOME/Library/Caches/gopls（Windows）重试 - 项目根目录若有
go.work文件，确保它引用的各个 module 目录都存在且可读；否则gopls会静默失败
go env 输出是否和你预期的一致。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
