核心用法
SQLite 是一个零配置、服务器端的嵌入式关系数据库，无需独立进程即可运行。本技能文档系统梳理了生产环境必备的核心技术点：
并发与WAL模式 — SQLite 最大痛点。仅支持单写多读，默认模式会阻塞读操作。启用 PRAGMA journal_mode=WAL 可实现读写并发，配合 PRAGMA busy_timeout=5000 避免 SQLITE_BUSY 错误。注意 WAL 会生成 -wal 和 -shm 辅助文件，备份时必须同步复制。
数据完整性 — 外键约束默认关闭！每个连接必须执行 PRAGMA foreign_keys=ON，否则级联删除等约束完全失效。建议连接后立即检查返回值确认开启。
类型与Schema — 传统表为"类型亲和"机制，INTEGER 列可存入字符串而不报错。SQLite 3.37+ 支持 STRICT 严格表模式强制类型校验。无原生布尔/日期类型，需用 INTEGER 0/1 或 ISO8601 文本存储。
性能调优 — 关键配置组合：cache_size 调至 64MB 以上、synchronous=NORMAL 配合 WAL 平衡安全与速度、temp_store=MEMORY 加速排序。批量操作务必显式包裹 BEGIN...COMMIT，速度提升 10-100 倍。长期连接关闭前执行 PRAGMA optimize 更新查询规划器统计信息。
维护操作 — DELETE 不会释放文件空间，需定期 VACUUM 重写数据库（需 2 倍磁盘空间）。3.27+ 版本可用 VACUUM INTO 直接生成独立备份副本。
显著优点
- 零运维成本：无服务进程、无权限配置、单文件即数据库
- WAL 模式突破：读写并发能力满足大多数桌面/移动端场景
- 现代特性演进：3.35+ 支持
DROP COLUMN，3.37+ 支持STRICT类型，持续活跃开发 - 高级索引：表达式索引、部分索引、覆盖索引完整支持
潜在缺点与局限
- 写并发瓶颈：单写锁设计天然不适合高并发写入场景（如多用户 Web 后端），应果断迁移至 PostgreSQL
- 有限 ALTER 能力：修改列类型、添加约束仍需重建表流程
- 类型系统混乱：历史遗留的类型亲和机制易导致隐式转换 Bug
- ROWID 不可靠：
VACUUM会重新分配，依赖它做主键会导致数据关联断裂
适合人群
- 桌面应用、移动 App（iOS/Android）、IoT 设备本地存储开发者
- 中小型数据分析、测试环境、嵌入式系统工程师
- 需要嵌入数据库但无 DBA 资源的独立开发者和小团队
常规风险
- 并发陷阱：未启用 WAL + busy_timeout 的生产环境必现随机失败
- 静默数据损坏：外键关闭时违反约束无警告、类型亲和导致脏数据入库
- 备份失误：直接复制打开中的数据库文件或遗漏 WAL 文件导致不可恢复损坏
- 内存数据库误用：
:memory:每个连接隔离，共享内存需用file::memory:?cache=shared语法