Golang项目实战：基于SQLite的联系人管理器_基础数据库操作-Golang-PHP中文网

用 database/sql 而非 mattn/go-sqlite3 裸 API，导入驱动后 sql.Open 初始化，建表加 IF NOT EXISTS，设 PRAGMA journal_mode = WAL，增删改用 Exec 配 LastInsertId，单行查用 QueryRow，批量插入用多值语句，时间存 Unix 时间戳，事务用 defer 判断 nil 和提交状态确保回滚安全。

golang项目实战：基于sqlite的联系人管理器_基础数据库操作

SQLite 在 Go 里用 `database/sql` 就够了，别碰 `mattn/go-sqlite3` 的裸 API

Go 官方 database/sql 接口抽象得足够好，SQLite 驱动（mattn/go-sqlite3）只是个后端实现。直接调用它的 sqlite3.Open 或手写 C. 相关逻辑，反而绕开连接池、事务封装和上下文取消支持，后续加并发或超时会踩坑。

常见错误现象：panic: runtime error: invalid memory address，往往源于手动管理 *sqlite3.SQLiteConn 后忘了 Close，或在多 goroutine 中复用非线程安全的裸连接。

初始化只做两件事：导入驱动 _ "github.com/mattn/go-sqlite3"，再用 sql.Open("sqlite3", "contacts.db")
建表语句必须带 IF NOT EXISTS，否则每次重启程序都可能报 table contacts already exists
PRAGMA journal_mode = WAL 建议在 Open 后立刻执行一次，提升并发读写性能，但注意它不支持内存数据库（:memory:）

`Exec` 和 `QueryRow` 别混用：增删改用 `Exec`，单行查用 `QueryRow`

新手常把 INSERT 之后接 QueryRow，以为能拿到自增 ID —— 实际上 QueryRow 会尝试解析结果集，而 INSERT 没有返回列，导致 Scan 报 sql: no rows in result set 或静默失败。

正确姿势是：用 Exec 执行增删改，再调 Result.LastInsertId() 拿 ID；单行查询（如按 ID 查联系人）才用 QueryRow。

INSERT INTO contacts (name, phone) VALUES (?, ?) → db.Exec(...) → lastID, _ := res.LastInsertId()
SELECT name, phone FROM contacts WHERE id = ? → db.QueryRow(...).Scan(&name, &phone)
批量插入别用循环多次 Exec，改用参数化多值语句：INSERT INTO contacts VALUES (?,?),(?,?),(?,?)，最多一次塞 500 行，避免参数超限（SQLite 默认 999）

时间字段存 `INTEGER`（Unix 时间戳），别存 `TEXT` 或 `DATETIME`

SQLite 本身没有原生日期类型，DATETIME 是文本模拟，排序、范围查询（如“最近 7 天”）会出错：字符串比较 "2024-10-01" "2024-9-30" 成立，但逻辑上不成立。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

存 INTEGER 用 time.Now().Unix()，查的时候转回 time.Unix(ts, 0)，简单可靠。

建表写 created_at INTEGER NOT NULL，不是 DATETIME DEFAULT CURRENT_TIMESTAMP
WHERE 条件写 created_at >= ?，参数传 sevenDaysAgo.Unix()，别拼字符串
如果必须导出可读时间，用 strftime('%Y-%m-%d %H:%M', created_at, 'unixepoch') 在 SQL 层转换，而不是在 Go 里反复 time.Unix(...).Format(...)

事务没 Commit 就退出？用 `defer tx.Rollback()` + 显式 `Commit` 配合

Go 的 defer 看似方便，但写成 defer tx.Rollback() 然后在成功路径里忘掉 tx.Commit()，会导致每次操作都回滚 —— 表面无报错，数据就是不落盘，极难排查。

真正安全的写法是：先 defer func() 匿名函数，在里面判断 tx 是否为 nil 且未提交，再决定是否回滚。

标准模板：

tx, err := db.Begin()
if err != nil {
    return err
}
defer func() {
    if tx != nil {
        tx.Rollback()
    }
}()
// ... 操作
if err := tx.Commit(); err == nil {
    tx = nil // 标记已提交
}