Go未识别是PATH未配置，国内go get失败因代理不通，需设GOPROXY；gin.Default()警告属正常提示，connection refused说明服务未启动，关键在PATH、代理、引擎创建顺序三处。
go version 不识别或报 command not found
说明 Go 二进制没进系统 PATH，不是“没装好”，而是“没认到”。Windows 用户常漏掉把 C:\Go\bin 加进系统环境变量；Linux/macOS 用户则容易只改了当前 shell 的 ~/.bashrc，但没执行 source ~/.bashrc，或用了 zsh 却改了 bash 配置。
验证方式：终端里直接运行 which go（macOS/Linux）或 where go（Windows），无输出即失败。修复后务必新开终端再试 go version，别在当前已启动的终端里硬 reload。
go mod init 后 go get github.com/gin-gonic/gin 失败
国内直连 GitHub 常因网络问题超时或 404，错误信息里通常含 Get "https://proxy.golang.org/..." 或 timeout。这不是 Gin 本身的问题，是模块代理不通。
立即生效的解决办法：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，七牛云维护，稳定） - 或换阿里云镜像：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 顺手加一句：
go env -w GO111MODULE=on，避免旧项目误启 GOPATH 模式
执行完再 go get github.com/gin-gonic/gin，会看到 go.mod 和 go.sum 自动更新。不用加 -u 参数——新项目首次安装，-u 反而可能拉取不兼容的预发布版。
gin.Default() 启动后控制台刷一堆 [GIN-debug] 警告
最常见两条：
-
[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.—— 这不是错，是提示你gin.Default()已自带日志和 panic 恢复，别重复r.Use(gin.Logger()) -
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.—— 开发期无害，但上线前必须关掉调试模式，否则暴露内部路径、堆栈等敏感信息
生产环境切换方式（任选其一）：
- 启动前设环境变量：
GIN_MODE=release go run main.go - 代码里提前调用：
gin.SetMode(gin.ReleaseMode)，且必须在gin.Default()之前
注意：gin.New() 不带任何中间件，适合完全自控链路的场景，但新手别碰——缺 Logger 和 Recovery 容易让 panic 直接崩服务，连错误都看不到。
curl http://localhost:8080/ping 返回 connection refused
说明服务根本没起来，不是路由写错，而是进程没跑或端口被占。
排查顺序：
- 检查
r.Run(":8080")是否写在main()最后，且没被return或 panic 截断 - 确认没写成
r.Run("8080")（漏了冒号），正确格式是:8080或0.0.0.0:8080 - Linux/macOS 下执行
lsof -i :8080，Windows 用netstat -ano | findstr :8080，看端口是否已被占用 - 如果用 IDE 运行，留意终端输出是否有 panic 报错——比如
listen tcp :8080: bind: address already in use，那就得换端口
最简验证法：删掉所有路由，只留 r.GET("/", func(c *gin.Context) { c.String(200, "ok") })，再跑一次。能访问就说明框架通了，问题出在后续逻辑里。
gin.Default() + r.Run()。其余警告和错误，90% 都卡在这三个点上。真正容易被忽略的，是 go env 配置只对新开终端生效，以及 gin.SetMode 必须在引擎创建前调用——这两处没做对，调试期看着正常，上线就翻车。 
