Buffalo不读database.yml，必须设置DATABASE_URL环境变量；models.NewDB()仅从os.Getenv("DATABASE_URL")获取连接串，config/database.yml仅为占位模板，为空或格式错误将导致buffalo dev panic。
Buffalo 不读 database.yml，必须设 DATABASE_URL 环境变量，否则连不上数据库——这是最常卡住开发者的一步。
为什么 database.yml 里填对了也没用
Buffalo 的 models.NewDB() 函数默认从 os.Getenv("DATABASE_URL") 拿连接串，config/database.yml 只是个占位模板，框架启动时完全不解析它。你改十遍 database.yml，只要 DATABASE_URL 为空或格式错，buffalo dev 就会 panic 或报 failed to open connection。
- 验证方式：运行
echo $DATABASE_URL，输出应为完整连接串；为空就立刻补上 - PostgreSQL 示例：
export DATABASE_URL="postgres://user:pass@localhost:5432/myapp_development?sslmode=disable" - MySQL 示例：
export DATABASE_URL="mysql://user:pass@127.0.0.1:3306/myapp_development?parseTime=true" - SQLite3 要求系统有
gcc，且 URL 形如：export DATABASE_URL="sqlite3://./development.sqlite"
DATABASE_URL 格式和驱动导入必须严格匹配
即使 URL 字符串看着对，如果对应驱动没被 Go 导入，依然报 unknown dialect 或 driver: unknown driver。Pop 不会自动注册驱动，必须手动 _ 空导入。
- PostgreSQL：在
models/models.go里import _ "github.com/lib/pq"（注意是pq，不是postgresql） - MySQL：
import _ "github.com/go-sql-driver/mysql"（dialect 必须写"mysql"，不能写"mariadb"） - SQLite3：
import _ "modernc.org/sqlite"，且需确保系统能编译 C 代码（macOS ARM64 上可能失败） - 执行
go mod tidy补全依赖，否则buffalo db migrate直接 panic
GO_ENV 必须显式导出，不能靠 .env 文件
Buffalo 不自动加载 .env，GO_ENV 值决定 models.NewDB() 内部是否走不同逻辑分支（比如拼接 URL、查不同配置块）。若未导出，app.Env 默认是 "development"，但代码里若写了 if app.Env == "production" 判断，就会误入错误路径。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 运行
echo $GO_ENV，为空就执行export GO_ENV=development - 别指望
buffalo dev自动设好——它只影响日志和热重载，不控制配置加载逻辑 - 企业项目中，
GO_ENV常用于区分 staging / production 连接池参数，值必须与部署环境一致
Windows 用户要禁用 GOPATH，否则所有 DB 命令失效
Buffalo 强制使用 Go modules，Windows 下若启用了 GOPATH 模式（比如设置了 GO111MODULE=off 或存在 go.mod 外的旧项目目录），buffalo dev 和 buffalo db migrate 会静默失败或 panic。
- 检查：
go env GOPATH和go env GO111MODULE，后者必须为on - 临时修复：
set GO111MODULE=on（Windows CMD）或$env:GO111MODULE="on"（PowerShell） - Go 版本只能是
1.23.x或1.24.x；go version输出含1.22或1.25会导致迁移崩溃且无明确提示
最容易被忽略的是：URL 中的 sslmode=disable（PostgreSQL）或 parseTime=true（MySQL）这类参数不是可选的——缺了它们，驱动可能无法解析时间字段或拒绝连接，错误信息却只显示“connection refused”。
