sqlite在go中嵌入需卡死三步：启用cgo（否则编译报undefined reference）、dsn用绝对路径并确保父目录存在、db.ping()后显式执行pragma foreign_keys=on/journal_mode=wal/encoding='utf-8'。
SQLite 在 Go 里能嵌入，但不是“复制个文件就跑”，关键在于驱动选型、CGO 控制和 PRAGMA 初始化这三步卡死——漏掉任意一个，db.Ping() 就会报错或行为异常。
go-sqlite3 必须启用 CGO，否则编译直接失败
这是最常被跳过的硬性前提：go-sqlite3 是 C 绑定驱动，不启用 CGO 就没有 sqlite3_open_v2 符号。错误现象是 undefined reference to 'sqlite3_open_v2'，尤其在 Alpine 容器、CI 构建或 CGO_ENABLED=0 环境下必现。
- Linux（Debian/Ubuntu）：装
libsqlite3-dev，不是sqlite3 - macOS（Homebrew）：确认
PKG_CONFIG_PATH指向/opt/homebrew/lib/pkgconfig或/usr/local/lib/pkgconfig - Windows（MSVC）：必须设
CGO_ENABLED=1，且确保cl.exe在 PATH 中 - 构建命令示例：
CGO_ENABLED=1 go build -o app ./main.go
dsn 要用绝对路径，且父目录必须手动创建
sql.Open("sqlite3", "./data.db") 看似简单，但工作目录一变就失效；SQLite 驱动不会帮你 mkdir -p 父目录，unable to open database file 错误八成出在这儿。
- 推荐写法：
dbPath := filepath.Join(os.TempDir(), "myapp.db")，再os.MkdirAll(filepath.Dir(dbPath), 0755) - 内存数据库可绕过路径问题：
"file::memory:?cache=shared"，但注意它不持久化 - 别在 DSN 里塞用户名密码：
user:pass@/path会被解析为非法 URL，触发driver: bad connection
PRAGMA 必须在 db.Ping() 后显式执行
SQLite 默认关闭外键、用 DELETE 日志模式、不校验 UTF-8，这些不是“可选项”，而是并发安全和数据一致性的基础。驱动不会自动帮你开，db.Exec("PRAGMA ...") 必须紧跟 db.Ping()。
- 必须设置的三项：
PRAGMA foreign_keys = ON、PRAGMA journal_mode = WAL、PRAGMA encoding = 'UTF-8' - WAL 模式开启后，快照隔离才真正生效，但前提是所有读写都走同一个
*sql.Tx - 不要依赖 DSN 参数如
?_pragma=journal_mode=WAL——mattn/go-sqlite3不支持该语法，只有纯 Go 的go-sqlite支持
事务操作必须全程使用 tx 对象，混用 db.* 就等于没事务
写 tx, _ := db.Begin() 只是开了个事务句柄，后续所有语句必须调 tx.Query、tx.Exec，否则查到的是旧快照，改的也是独立副本，tx.Rollback() 后什么都留不下。
- 禁止在事务中穿插
db.Query("SELECT ...")，哪怕只是日志查询 - 需要强排他锁时，别用默认
Begin()，改用：db.BeginTx(ctx, &sql.TxOptions{Isolation: sql.LevelExclusive}) -
tx.Commit()和tx.Rollback()都要显式调；defer tx.Rollback()前加if tx != nil判断，避免 panic - 别在一个事务里交替用
tx.QueryRow和tx.Exec，某些 SQLite 版本会静默卡住或返回空结果
最易被忽略的点：WAL 模式 + 外键 + UTF-8 这三项 PRAGMA 设置，必须在 db.Ping() 成功后立即执行，且不能放在 init() 或连接池复用逻辑里——每次新 *sql.DB 实例都要重做一遍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
