先运行go version：报command not found说明PATH未生效，输出旧版本则存在残留；用which go或where go定位二进制，避免多源安装冲突；教学建议直接解压官方包并手动配置PATH；VS Code卡在“Installing tools”需前置设置GOPROXY和GOSUMDB；go mod init参数是模块路径而非目录名；HTTP服务需log.Fatal(err)阻塞进程，防静默退出。
go version 输出异常或 command not found 怎么办
教学演示最怕开场就卡在环境验证环节。先别急着重装，直接运行 go version —— 如果报错 command not found，说明 PATH 没生效；如果输出版本但低于 go1.18（比如 go1.16.15），那大概率是旧版残留干扰。
排查顺序很关键：
- 用
which go（macOS/Linux）或where go（Windows PowerShell）看实际调用的是哪个二进制 - 检查是否混用了 Homebrew、MSI、官方 tar.gz 多种安装方式，导致多个
/usr/local/go/bin/go、C:\Go\bin\go.exe并存 - 教学机建议跳过包管理器，直接下载官方
go1.22.3.darwin-arm64.tar.gz或对应包，解压到/usr/local/go（macOS/Linux）或C:\Go（Windows），再把/usr/local/go/bin或C:\Go\bin加进 PATH
VS Code 打开 .go 文件后一直提示 “Installing tools” 卡住
这是新手演示现场高频问题：不是插件没装，而是工具链下载被墙或超时。VS Code 的 Go 插件默认会尝试拉取 gopls、dlv、goimports 等，但国内直连 golang.org/x/... 基本失败。
解决方法必须前置配置，不能等弹窗出现再操作：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 打开终端，提前执行：
go env -w GOPROXY=https://goproxy.cn,direct - 再执行：
go env -w GOSUMDB=off（教学演示可临时关闭校验，避免因 checksum mismatch 中断） - 重启 VS Code，新建
main.go后，右下角状态栏点“Go: Install All Tools”，此时应能快速完成
go mod init 之后 go run main.go 报错 “cannot find module providing package”
这不是代码写错了，而是模块初始化路径不匹配。常见于学生照抄教程，在桌面或任意目录直接 go mod init hello，但没注意当前目录名和模块名不一致。
教学中要强调两点：
-
go mod init的参数是模块路径（如example.com/demo），不是项目文件夹名；它只写进go.mod，不影响文件系统 - 只要
main.go在当前目录且包名是main，go run main.go就能跑通，和模块名无关 - 真正出错往往是：误在子目录里执行了
go run ../main.go，或把main.go放进了cmd/子目录却没调整入口逻辑
演示 HTTP 服务时浏览器打不开 localhost:8080
写完 http.ListenAndServe(":8080", nil) 却访问失败，90% 是因为程序已退出 —— 没加阻塞逻辑。
教学代码务必显式处理这点：
- 最简方案：在
http.ListenAndServe后加log.Fatal(err)，否则错误被吞掉，进程静默退出 - 更稳妥写法：
if err := http.ListenAndServe(":8080", nil); err != nil { log.Fatal(err) } - 别用
time.Sleep(10 * time.Second)模拟“保持运行”，它只是延时退出，无法响应请求
真正容易被忽略的，是防火墙或端口占用——教学机常预装杀毒软件或 Docker 占用 8080，换端口（比如 :8081）比查进程更快。
