给 SQLite 集成加密最稳妥的方案是直接替换底层库为 SQLCipher，它在编译期或运行期接管数据页的读写，对上层业务代码几乎无侵入。

命令速用版

如果你已经安装了 sqlcipher 命令行工具，可以通过以下命令快速加密现有数据库：

sqlcipher plaintext.db
PRAGMA key='YourStrongPassword123!';
ATTACH DATABASE 'encrypted.db' AS encrypted KEY 'YourStrongPassword123!';
SELECT sqlcipher_export('encrypted');
DETACH DATABASE encrypted;

对于新数据库，直接在打开后设置密钥即可：

sqlcipher new.db
PRAGMA key='YourStrongPassword123!';
CREATE TABLE secure_data(id INTEGER PRIMARY KEY, info TEXT);

为什么会这样

原生 SQLite 设计初衷是轻量级，数据文件默认以明文存储，任何能访问文件的人都可以直接读取内容。SQLCipher 作为扩展库，在 SQLite 内核基础上增加了加密层，采用 AES-256 算法对数据页进行加密。这意味着数据在写入磁盘前被加密，读取到内存后解密，对应用层而言，除了打开数据库时需要提供密钥外，后续的 SQL 操作与普通 SQLite 完全一致。

分步处理

1. 环境准备与安装
在 Linux 环境下，可以直接通过包管理器安装：
sudo apt install sqlcipher
如果需要集成到项目中（如 C/C++、Qt、iOS 等），通常需要编译源码。编译时需启用加密模块配置，例如在 configure 阶段添加`--enable-tempstore`=yes和CFLAGS="-DSQLITE_HAS_CODEC"。Windows 用户可使用 Visual Studio 配合 CMake 编译，注意需要依赖 OpenSSL 库。

2. 替换链接库
在代码项目中集成时，必须确保链接的是 sqlcipher 库而不是系统自带的 sqlite3 库。例如在 Xcode 项目中，需移除libsqlite3.dylib，添加编译好的 sqlcipher 静态库，并在 Header Search Path 中指定 sqlcipher 的头文件路径。

3. 设置密钥
在打开数据库连接后，执行写操作前，必须第一时间设置密钥。使用PRAGMA key='your_secret_key';命令。如果是通过 API 调用，可使用sqlite3_key()函数。密钥设置成功后，后续创建的表和数据都会自动加密。

4. 迁移现有数据
如果已有明文数据库需要加密，不要直接修改原文件。使用ATTACH命令挂载一个新数据库，设置新库的密钥，然后使用sqlcipher_export函数或INSERT INTO ... SELECT ...将数据导出到加密库中，最后替换原文件。

怎么验证是否生效

1. 文件内容检查
使用十六进制编辑器或hexdump -C命令打开加密后的.db文件。未加密的 SQLite 文件头部通常可见SQLite format 3明文标识，而加密后的文件头部及内容应显示为随机乱码。

2. 无密钥访问测试
尝试使用标准的sqlite3命令行工具打开加密后的数据库。如果集成成功，标准工具应无法识别文件或报错提示文件加密，只有使用sqlcipher命令并提供正确密钥才能查询数据。

常见坑

1. 密钥丢失不可恢复
SQLCipher 的加密强度较高，一旦密钥丢失，数据基本无法找回。务必做好密钥管理，不要硬编码在代码仓库中。

2. 混合使用命令工具
加密后的数据库必须使用sqlcipher命令打开，不能用标准sqlite3命令。如果在脚本中混用，会导致无法读取或误以为数据损坏。

3. 性能与模式兼容
加密和解密过程会带来一定的计算开销。部分资料提到开启 WAL 模式时需注意兼容性，建议在加密前先测试业务场景下的读写性能。此外，编译时需确保 OpenSSL 等依赖库版本匹配，否则可能出现链接错误。

参考来源

• 5 步搞定微服务数据加密:SQLCipher 终极实战指南
• SQLite3 集成 SqlCipher 加密功能的跨平台编译与实战应用
• 使用 Qt 插件和 SQLCipher 实现 SQLite 数据库加密与解密
• SQLite 加密：为你的数据库增加一层安全保护
• sqlite3 加密方案 sqlcipher，及 sqlcipher 使用指南_c# sqlcipher 依赖
• 最完整 SQLCipher 使用指南：从安装到实战加密全流程
• SQLite 加密 -- SQLCipher - EileenLeung - 博客园
• SQLite 进阶：扩展功能与最佳实践