如何在 Go 中实现基于 SQLite 的嵌入式数据库方案-Golang-PHP中文网

go 没有原生 sqlite 绑定，github.com/mattn/go-sqlite3 是基于 cgo 的驱动，仅实现 database/sql/driver 接口，不提供独立 api；直接 import "sqlite3" 会编译失败，因其非标准包且依赖 c 编译器和 sqlite 头文件。

如何在 go 中实现基于 sqlite 的嵌入式数据库方案

Go 本身不内置 SQLite 支持，必须通过 github.com/mattn/go-sqlite3 驱动 + database/sql 标准接口组合使用；直接 import "sqlite3" 会编译失败。

为什么不能直接用 sqlite3 包？

Go 没有原生 SQLite 绑定，mattn/go-sqlite3 是 Cgo 驱动，依赖系统级 SQLite 库或自带 amalgamation 编译。常见错误包括：

undefined: sqlite3.Open —— 误以为它提供独立 API，实际只实现 database/sql/driver 接口
cgo: C compiler not found —— 忘记启用 CGO（CGO_ENABLED=1），尤其在 Alpine 容器中需额外装 musl-dev 和 sqlite-dev
Windows 下提示找不到 libsqlite3.dll —— 不是运行时依赖，而是编译期需要头文件和静态库

初始化数据库连接的最小可靠写法

关键不是“打开文件”，而是配置好 sqlite3 特有的连接参数，否则默认行为容易踩坑：

使用 file:memdb1?mode=memory&cache=shared 创建纯内存 DB（适合测试）
生产文件路径建议用绝对路径，相对路径基于当前工作目录（os.Getwd()），不是二进制所在目录
必须设置 _loc=auto 参数避免时区错乱（SQLite 无原生 datetime 类型，存的是字符串或 Unix 时间戳）
加 _busy_timeout=5000 防止写冲突时 panic，而不是默认的立即报 database is locked

示例：

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

db, err := sql.Open("sqlite3", "./data/app.db?_busy_timeout=5000&_loc=auto")
if err != nil {
    log.Fatal(err)
}
db.SetMaxOpenConns(1) // SQLite 不支持并发写，设为 1 最安全

执行 DDL 和参数化查询的注意事项

SQLite 的 SQL 语法宽松，但 Go 驱动对某些写法敏感：

CREATE TABLE IF NOT EXISTS 可以用，但 ALTER TABLE ... ADD COLUMN IF NOT EXISTS 在旧版 SQLite（
参数占位符只能用 ?，不支持命名参数（如 :name 或 $1），否则报 no such column: ?
插入后想获取主键，必须用 stmt.LastInsertId()，不能依赖 RETURNING（SQLite 3.35+ 才支持，且驱动未透出该特性）
批量插入别用循环 Exec，改用事务 + 单条 INSERT INTO ... VALUES (?,?), (?,?) 多值语法，性能差 10 倍以上