go version报错或显示旧版本，主因是环境变量未生效：Windows需重启终端，Linux/macOS需source配置文件；用go env和which go确认GOROOT及真实路径，清理PATH中旧Go残留。
go version 命令报错或显示旧版本怎么办
说明：环境变量没生效是最常见原因，尤其在 Windows 上改了系统变量后没重启终端，或 Linux/macOS 没 source 配置文件。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go env看GOROOT和PATH是否指向你刚装的目录（比如/usr/local/go或C:\Go） - Windows 用户注意：改完“系统变量”后，必须新开一个 CMD/PowerShell；改“用户变量”也一样，旧窗口不会自动刷新
- Linux/macOS 用户检查
~/.bashrc、~/.zshrc或/etc/profile里是否漏写了export PATH=$PATH:$GOROOT/bin - 如果
go version显示的是go1.16这类老版本，大概率是 PATH 里有旧安装残留（比如 Homebrew 装过旧版），用which go查真实路径，删掉或挪开
go mod init 报错 “no Go files in current directory”
说明：这是新手演示时高频踩坑点——go mod init 不依赖当前目录是否有 .go 文件，但它会读取当前目录下所有 .go 文件来推导 module path。如果目录为空或只有 main.go 但文件内容不合法（比如没 package main），就会报这个错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保当前目录下至少有一个语法正确的 Go 文件，比如
main.go内容为：package main import "fmt" func main() { fmt.Println("hello") } - 运行
go mod init example.com/demo，module name 可以任意起，但不能含空格或中文 - 别直接在
$GOPATH/src下操作——Go 1.11+ 默认启用 modules，GO111MODULE=on时GOPATH不影响模块初始化位置 - 如果仍报错，用
ls -la或dir确认当前目录没隐藏文件干扰（比如 .git、.vscode）
VS Code 调试时提示 “Delve not installed”
说明：Go 扩展默认不自带调试器 Delve，教学演示中点击「Run and Debug」→「play」图标失败，基本就是这个原因。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在 VS Code 终端里执行
go install github.com/go-delve/delve/cmd/dlv@latest（注意不是go get） - 安装完成后，
dlv version应能正常输出；再确认 VS Code 的设置里go.dlvLoadConfig和go.toolsManagement.autoUpdate是 true - Windows 用户若遇到权限问题，用管理员身份打开 PowerShell 再执行安装命令
- 别手动下载二进制丢进 PATH——Delve 版本需与 Go 版本兼容，
@latest能自动匹配
学生 clone 示例项目后 go run . 报依赖缺失
说明：教学仓库通常只提交 go.mod 和 go.sum，没传 vendor 目录。学生本地 GOPROXY 配置错误或网络不通时，go run 会卡住或报 cannot load 错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 统一要求学生运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐，比阿里云镜像更稳定） - 提醒学生首次运行前先执行
go mod download，观察是否成功拉取所有依赖；失败时看错误里具体缺哪个 module - 教学演示机可提前跑一遍
go mod vendor，把依赖打进vendor/目录，这样学生离线也能跑 - 避免用
go get单独装包——它会修改go.mod，教学场景下应保持依赖声明干净
go version 显示混乱，后者让断点根本不起作用——这两处不现场排查，演示十次有八次卡住。 
