必须显式导入 _ "github.com/lib/pq" 并置于 main.go 或 ORM 初始化文件的包级导入中，早于 orm.RegisterDataBase；连接字符串须含 sslmode=disable（开发）或 sslmode=require（生产），否则报 driver: unknown driver "postgres" 错误。
必须显式导入 github.com/lib/pq 驱动包
Beego ORM 本身不打包任何数据库驱动，github.com/beego/beego/v2/client/orm 只是抽象层。不手动引入 PostgreSQL 驱动，orm.RegisterDataBase 会直接报错：driver: unknown driver "postgres" (forgotten import?)。
正确做法是使用空白导入（underscore import）触发其 init() 函数注册驱动：
-
go get github.com/lib/pq是必须执行的命令，不能跳过 - 导入语句必须写在
main.go或 ORM 初始化入口文件（如models/init.go）的包级作用域 - 不能写在 controller、model 文件里（除非该文件被
main.go显式导入） - 不能写在
func main()内部（Go 语法错误）
orm.RegisterDataBase 连接字符串必须含 sslmode=disable
PostgreSQL 服务默认启用 SSL 检查；本地开发未配证书时，缺少 sslmode=disable 会导致连接失败，典型错误包括：dial tcp 127.0.0.1:5432: connect: connection refused 或 server does not support SSL, but SSL was requested。
该参数由 lib/pq 驱动解析，Beego ORM 不做处理，所以拼写必须严格：
- 小写，无空格，不可写作
SSLMode或ssl mode=disable - 开发环境用
sslmode=disable；生产环境应配证书并改用sslmode=require或sslmode=verify-full - 完整示例：
"user=postgres password=mypass dbname=mydb host=127.0.0.1 port=5432 sslmode=disable"
驱动注册和数据库注册的顺序不能颠倒
即使导入了 _ "github.com/lib/pq"，如果 orm.RegisterDataBase 调用发生在驱动生效前，依然会失败。常见陷阱：
- 把
import _ "github.com/lib/pq"放在main.go的import块末尾，但init()函数里先调用了orm.RegisterDataBase→ 驱动尚未加载 - 使用
conf/app.conf动态拼接 DSN，但orm.RegisterDriver("postgres", orm.DRPostgres)被省略或位置靠后 → Beego v2 中虽可省略该行，但显式保留更稳妥 - 多个
init()函数存在时，Go 初始化顺序依赖导入顺序，建议把驱动导入和 ORM 注册都收束到同一个init()中
模型注册与自动建表需确认 RunSyncdb 执行时机
orm.RunSyncdb("default", false, true) 必须在 orm.RegisterDataBase 和 orm.RegisterModel 之后调用，否则不会生效。注意：
-
false表示不删除已有表结构，true表示自动创建缺失表 —— 仅对首次运行或新增 model 有效 - 若已存在表但字段不匹配，不会自动更新结构；需手动迁移或设为
true并清空库重试 - 确保所有
models/*.go文件中的init()被触发（例如通过import _ "yourapp/models"在main.go中导入）
驱动导入位置、sslmode 参数、初始化顺序这三者必须同时满足，缺一不可。最容易被忽略的是：看似写了导入，却因文件未被引用或顺序错乱导致驱动根本没加载。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
