AutoHotkey v2 SQLite 数据库深度实战:sqlite3.dll 封装、增删改查、预处理语句、事务与批量性能优化完全指南
当你的脚本需要**持久化数据**——记住用户配置、缓存查询结果、记录操作日志、分析历史数据——纯文本文件和 INI 就开始显得力不从心:没有索引、并发写入互相覆盖、查询要靠逐行正则…… 这个时候,**SQLite** 是 AutoHotkey 脚本的最佳搭档。它是世界上部署最广的嵌入式关系型数据库,单文件、零安装、完全离线,通过一个几 MB 的 `sqlite3.dll`,你就能在 AHK 里获得完整的 SQL 能力。
本文是「AutoHotkey v2 深度实战」系列的第 18 篇,将彻底拆解在 AHK v2 中驾驭 SQLite 的全过程。我们不满足于「能跑」,而是要讲清**底层 C API 如何映射到 DllCall**、**为什么预处理语句又快又安全**、**事务与批量提交如何带来 100 倍性能提升**、以及**x86/x64、UTF-8、内存管理这些最容易踩的坑**。读完你将能自己封装一个小而美的数据库操作层,并写出工程级的可靠代码。
### 目录
1. 为什么 AHK 需要 SQLite:从 INI 到数据库的跃迁
2. 获取与加载 `sqlite3.dll`:架构匹配与初始化
3. SQLite C API 全景:一张表看懂要用的函数
4. 打开与关闭数据库:句柄的生命周期
5. 无回调的快速执行:`sqlite3_exec`
6. 预处理语句 `sqlite3_prepare_v2`:参数化查询的核心
7. 绑定参数:彻底告别 SQL 注入
8. 读取结果集:`sqlite3_step` + 逐列取值
9. 封装一个干净的 `SqliteDB` 类
10. 增删改查完整实战:通讯录管理
11. 事务与批量性能:从秒级到毫秒级
12. PRAGMA 调优:WAL、同步、缓存与内存库
13. 错误处理与多线程安全
14. 与其他特性集成:设置中心、日志、缓存与定时落盘
15. 高频踩坑与最佳实践总结


你这篇不是用Ai生成的吧?复制的代码跑不通!
感谢反馈,已经排查并修正了。这篇里确实有一个会导致「复制跑不通」的问题:`SqliteDB` 类在 `sqlite3_open_v2` 之前没有先加载 `sqlite3.dll`,导致首次打开数据库时 DLL 还没就位直接失败。现已把 `_ensureLoaded()` 提前到打开数据库之前,正文已同步更新。
运行前还有两点请留意:
1. **sqlite3.dll** 不是 Windows 自带的,需先下载放到脚本同目录:到 https://www.sqlite.org/download.html 下载 `sqlite-dll-win-x64`(若 AHK 是 32 位则选 x86 版)。
2. 文章开头的示例依赖文末的完整 `SqliteDB` 封装类,建议**先把该类复制到脚本顶部,再抄下面的使用示例**,否则会报「SqliteDB 未定义」。
已按修正后的版本复核,类里 `query / exec / bindParams / transaction / lastID / changes` 均完整。欢迎再试,还有问题请贴出具体报错原文。