当前位置：首页 >专题 >Go 嵌入式 SQLite 数据库工程实践专题
Go 嵌入式 SQLite 数据库
Go 嵌入式 SQLite 数据库工程实践专题
从 CGo 与纯 Go 驱动、WAL 并发到嵌入、迁移、备份和测试
SQLite 适合本地优先应用、桌面工具、边缘服务和单机组件，但 Go 项目真正落地时，驱动是否依赖 CGo、database/sql 连接池如何使用、WAL 与锁如何治理、数据库文件怎样嵌入和备份，都会直接影响交付质量。本专题把官方 SQLite 文档、Go 驱动资料和站内实战文章串成一条可执行的工程路径。
官方入口与驱动选型
先建立 SQLite 事务、WAL 和 Go 驱动的正确边界
站内实战：连接、嵌入与数据操作
从第一条 CRUD 到把数据库文件随 Go 程序可靠交付
生产治理：WAL、备份与故障排查
处理 CGo 构建、并发锁、内存数据库和恢复演练
文章
二进制文件是使用“CGO_ENABLED=0”编译的，go-sqlite3 需要 cgo 才能工作。这是一个存根
解释 go-sqlite3 在 CGO_ENABLED=0 下的构建限制与报错原因。
常见问题
驱动、并发、备份和交付中的关键判断
Go 项目应该选 go-sqlite3 还是 modernc.org/sqlite？
如果项目已有稳定的 C 工具链、需要 go-sqlite3 的扩展或兼容现有方案，可以选择 CGo 路线；如果重视纯 Go 构建、交叉编译和减少系统依赖，应评估 modernc.org/sqlite。最终要以目标平台、SQLite 版本、扩展需求和基准测试决定。
开启 WAL 后为什么仍然会出现 database is locked？
WAL 允许读写并行，但仍只有一个写入者，长事务、未关闭 Rows、连接池配置、checkpoint 和升级到旧 SQLite 版本都可能触发 SQLITE_BUSY。应设置合理 busy timeout，缩短事务，检查连接使用方式，并确认 SQLite 版本包含当前修复。
把 SQLite 文件嵌入 Go 二进制后可以直接写入吗？
通常不能直接写入只读的嵌入资源。更稳妥的方式是首次启动时把资源复制到可写的数据目录，校验版本或迁移，再通过 database/sql 打开副本；如果使用 WAL，还必须把数据库、-wal 和 -shm 文件的生命周期一起考虑。
SQLite 备份能不能只复制主数据库文件？
在数据库连接和 WAL 活跃时不能简单只复制主文件；应使用 SQLite Backup API、VACUUM INTO 或在合适的 checkpoint/关闭状态下完成一致性备份，并在另一份环境实际恢复和校验。备份文件必须经过可恢复演练才算有效。
相关专题
继续查看相近方向内容
查看更多
最新文章
-
- AI 接口 504 后先查什么：X-Client-Request-Id、退避上限与幂等键
- 6小时前 171浏览
-
- AI 接口 504 后要不要重发：请求标识、退避与幂等核对
- 6小时前 229浏览
-
- AI 接口超时后怎么安全重试：请求标识、指数退避与结果去重
- 6小时前 482浏览
