Go 没有原生 SQLite 绑定，github.com/mattn/go-sqlite3 是基于 CGO 的驱动，仅实现 database/sql/driver 接口，不提供独立 API；直接 import "sqlite3" 会编译失败，因其非标准包且依赖 C 编译器和 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 倍以上
关闭连接与资源泄漏风险
SQLite 文件句柄不像网络数据库那样“长连接”，但漏掉 db.Close() 会导致：
- Windows 下无法删除或重命名 DB 文件（被进程占用）
- Linux 下虽可删，但若程序崩溃前没 close，WAL 日志可能残留，下次打开时自动回放，延迟可见
- 内存模式（
mode=memory）不 close 也会持续占内存，因为连接对象本身持有 C 层资源
正确做法：在 main 退出前或服务 shutdown hook 中显式调用 db.Close()，不要依赖 GC。
最易被忽略的一点：SQLite 的 WAL 模式默认开启，但 PRAGMA journal_mode=WAL 只对新连接生效；如果已有连接开着，执行该 PRAGMA 不会切换，也不会报错 —— 看似设了，实则无效。
