Go 开发环境不是装完 go 就能开干的，尤其当你从 PHP 转来、还要跑 Gin + GORM + PostgreSQL 的全栈项目时，缺一环就卡在 go run 报错或 gin.H{} 不生效这种低级问题上。
go 命令行工具链必须配对 GOPROXY 和 GOPATH
国内直连 golang.org 会超时，但只设 GOPROXY=https://goproxy.cn 不够——go mod download 可能仍因 checksum mismatch 失败，根源常是本地 GOPATH 指向了非标准路径（比如 Windows 下带空格的 C:\Users\My Name\go）。
-
GOPATH必须是纯 ASCII 字符、无空格、无中文的路径，推荐设为C:\go-workspace（Windows）或~/go-workspace（macOS/Linux） - 同时运行这两条命令才真正生效：
go env -w GOPROXY=https://goproxy.cn,direct go env -w GOPATH=/path/to/your/go-workspace
- 验证方式：执行
go env GOPROXY和go env GOPATH，输出必须和你设置的一致；若仍报checksum mismatch，删掉$GOPATH/pkg/mod/cache目录重试
Goland 中 module 初始化必须选对 Go version 和 proxy
用 Goland 新建项目时勾选 “Add Go Modules support” 是基础操作，但容易忽略两个关键点：Go 版本不匹配会导致 gorm.G[Model] 编译失败，proxy 未继承则 go get github.com/gin-gonic/gin 卡住不动。
- 新建项目对话框里，“Go version” 下拉必须选和你本地
go version输出一致的版本（如go1.25），不能选 “Auto-detect” - “Proxy settings” 必须手动填入
https://goproxy.cn，Goland 默认为空，不填就会走系统全局 proxy（可能没配）或直连失败 - 初始化后立刻执行
go mod tidy，观察 terminal 是否出现大量github.com/xxx: downloading—— 若卡在某一行超过 10 秒，大概率是 proxy 或网络问题，别硬等
GIN + GORM 启动时 panic 的真实原因常藏在 init 阶段
像 r := gin.Default() 看似简单，但一旦搭配 database.Init() 和配置加载，panic 往往发生在 main() 执行前的 init() 函数里，错误堆栈被截断，只显示 panic: runtime error: invalid memory address 这种废话。
立即学习“go语言免费学习笔记（深入）”；
- 检查
config.Init()是否在database.Init()之前调用——GORM 初始化依赖配置里的DB.Type和Server.Port，顺序反了必 panic - 确保
internal/database/database.go中的全局DB *gorm.DB变量是通过gorm.Open()赋值的，而不是声明即初始化（var DB = gorm.Open(...)会因配置未加载而传入空字符串） - 加一句日志定位：
log.Println("config loaded:", config.Get().Database.Write.Type) log.Println("about to init database...")如果第二行没打印就 panic，说明崩在第一行——配置结构体字段名写错（比如把Write写成write）或 TOML/YAML 键名大小写不匹配
最易被忽略的是：Gin 的 gin.Default() 会自动注册 recovery 中间件，但它捕获不到 init() 阶段的 panic。所以只要启动报错没堆栈，第一反应不是查路由或 handler，而是盯死配置加载和数据库连接这两步的执行顺序与参数合法性。
