Beego接入SQLite需四步全到位：下划线导入驱动、显式注册驱动和"default"别名数据库、注册模型、调用RunSyncdb建表；漏任一环节将panic或报no such table。
Beego 接入 SQLite 不是“导入驱动就能用”，漏掉任意一个注册环节就会 panic 或报 no such table ——核心问题在于驱动注册、数据库别名、模型注册、表同步四者必须全部到位。
sqlite3 驱动注册和 database alias 必须显式写
Beego ORM 默认不自动加载 SQLite 驱动，即使你 go get github.com/mattn/go-sqlite3 了，也得在代码里显式注册。否则运行时会 panic: driver not found。
- 必须下划线导入驱动：
_ "github.com/mattn/go-sqlite3"（触发init()注册） - 必须调用
orm.RegisterDriver("sqlite3", orm.DRSqlite)（虽然 Beego 内部已注册，但显式写更稳） - 必须用
orm.RegisterDataBase("default", "sqlite3", "data/app.db")注册，且别名只能是"default"—— ORM 默认只认这个别名，换别的（比如"sqlite"）会导致o.Using("sqlite")失败
路径写错不会报错，但 db 文件可能出现在意料之外的位置
Beego ORM 对 SQLite 路径异常“宽容”：如果 "data/app.db" 的父目录 data/ 不存在，它不会创建目录，也不会 panic，而是直接在当前工作目录（os.Getwd()）下拼出字面路径 data/app.db ——结果就是你反复检查项目根目录下的 data/，却始终找不到文件。
- 启动前手动创建目录：
os.MkdirAll("data", 0755)放在init()开头 - 路径建议用绝对路径或显式拼接：
filepath.Join(os.Getenv("PWD"), "data", "app.db")，避免工作目录变动导致错位 - 启动后立刻验证：
file data/app.db确认是否为 SQLite 数据库，而不是空文件或文本
表没建成功？RunSyncdb 是必走步骤，不能跳过
模型定义（type User struct{...}）和 orm.RegisterModel(new(User)) 只是告诉 ORM “有这张表”，不会真正建表。不调 orm.RunSyncdb()，插入时就会报 no such table: users。
立即学习“go语言免费学习笔记（深入）”；
- 必须在
main()函数中、beego.Run()之前调用：orm.RunSyncdb("default", false, true) - 参数含义：
false表示不删旧表（生产环境严禁设true），true表示打印建表 SQL（调试时开，上线前关） - 确保模型已注册：如果模型定义在
models/包里，init()里要import _ "./models"或显式调用orm.RegisterModel(...)
字段改了怎么办？AutoMigrate 在 SQLite 下基本不可靠
SQLite 的 ALTER TABLE 能力极弱，Beego 的 RunSyncdb 或 GORM 的 AutoMigrate 都无法支持字段类型变更、重命名、删除等操作。一旦你把 Name string 改成 Name *string，再跑 RunSyncdb，要么报 no such column，要么静默忽略。
- 开发阶段可接受：删掉
data/app.db，重新跑RunSyncdb - 测试/生产阶段必须用迁移工具：
bee migrate生成带时间戳的 SQL 迁移脚本，手动写ALTER TABLE ... ADD COLUMN等语句 - 别依赖 ORM 自动生成结构：SQLite 建表语句简单，建议手写
CREATE TABLE IF NOT EXISTS+db.Exec()初始化，更可控
最常被忽略的是目录创建和 RunSyncdb 调用时机——这两步不卡在编译期，也不报明显错误，但一运行就失败，debug 成本远高于提前加两行代码。
