SQLite是一个轻量级的嵌入式数据库，它把整个数据库存放在单个文件中，这种设计带来了极好的便携性，但也带来一个常见问题：当你删除了大量数据之后，会发现数据库文件的大小几乎没有变化。这是因为SQLite在删除数据时，只是把对应的数据页标记为空闲页，供后续写入复用，而不会立即把这些页从文件中裁剪掉。时间一长，数据库内部充满了空闲页和分散的数据页，文件体积虚高，查询性能也可能受影响。VACUUM命令就是解决这个问题的核心工具，它会重建整个数据库文件，回收空闲页并重新紧凑地排列数据。
VACUUM命令的工作原理是什么
要理解VACUUM的作用，首先需要了解SQLite的文件组织方式。SQLite数据库由多个固定大小的页组成，默认页大小是4096字节。每个表、索引的数据都存放在这些页中。当执行DELETE语句时，SQLite并不会真正擦除页中的内容，而是把这些页加入到一个名为freelist的空闲页链表中。后续执行INSERT时，SQLite会优先从freelist中取出空闲页来复用，但只要没有新的写入，这些空闲页就一直占据着文件空间。
VACUUM的核心思路非常直接：把旧数据库中的所有有效数据，按照顺序复制到一个全新的临时数据库文件中，然后用这个新文件替换旧文件。由于新文件只包含有效数据，没有任何空闲页，数据排列紧凑，因此体积往往大幅缩小。同时，表和索引的数据页在重建后会尽量连续存放，减少了页面的物理碎片，对全表扫描和范围查询都有一定性能提升。
VACUUM执行的过程中还会重建数据库的模式信息，等同于把所有表重新创建一遍，因此它还能顺带解决一些页级碎片问题，比如溢出页分布零散的情况。需要注意的是，VACUUM只对主数据库有效，附加数据库需要单独执行。基本用法如下：
-- 对当前连接的主数据库执行 VACUUM VACUUM; -- 也可以指定数据库名 VACUUM main;
VACUUM与auto_vacuum模式有什么区别
手动执行VACUUM有一个明显缺点：执行期间需要大约两倍于原数据库大小的磁盘空间，因为新旧两个文件会同时存在，而且整个过程会独占数据库，其他连接的写入会被阻塞。对于线上服务来说，这可能造成较长时间的不可用。为此，SQLite提供了另一种机制，称为auto_vacuum，可以在创建数据库时开启。
auto_vacuum有三种模式：NONE表示关闭，也就是默认行为；FULL模式下，当事务提交时，SQLite会自动把空闲页移动到文件末尾并截断文件，做到近似实时的空间回收；INCREMENTAL模式则允许开发者通过PRAGMA incremental_vacuum语句，分批回收空闲页，避免一次性大操作。开启方式如下：
-- 只能在数据库创建之前或 VACUUM 之后设置 PRAGMA auto_vacuum = FULL; PRAGMA auto_vacuum = INCREMENTAL; -- 增量模式下分批回收空闲页，每次最多回收 N 页 PRAGMA incremental_vacuum(100);
需要特别注意的是，auto_vacuum只能在空数据库上设置，如果数据库已经有数据，需要先执行一次VACUUM让它生效。另外，auto_vacuum FULL模式会带来额外的写放大，每次删除都要移动页指针，写入性能会略有下降，且空间回收的彻底程度不如手动VACUUM，因为它只截断文件尾部的空闲页，不会重排中间的数据页。因此，对于读写频繁的业务库，通常建议保持默认模式，定期在维护窗口执行手动VACUUM。
执行VACUUM需要注意哪些事项
第一，执行前务必备份。虽然VACUUM本身是安全的操作，但任何涉及整库重建的动作都应该以防万一，特别是没有WAL日志保护、磁盘可能意外断电的场景。可以使用.backup命令或SQLite的在线备份API先做一份完整备份。
第二，检查磁盘剩余空间。VACUUM执行时会在同目录下创建临时文件，如果剩余空间不足，操作会失败。虽然失败不会损坏原数据库，但会白白浪费时间。第三，VACUUM执行时会持有独占锁，所有其他连接的读写都会失败或等待，因此最好选择业务低峰期执行。第四，如果开启了PRAGMA foreign_keys等约束，VACUUM过程中会被临时禁用，结束后自动恢复，一般无需干预。
第五，判断是否需要VACUUM可以通过freelist的页数来估算，示例代码如下：
-- 查看空闲页数量 PRAGMA freelist_count; -- 查看数据库总页数和页大小 PRAGMA page_count; PRAGMA page_size; -- 估算可回收空间 = freelist_count * page_size -- 例如 2500 页 * 4096 字节 约 10 MB
一般来说，空闲页占比超过百分之二十，或者经历过大批量删除、导入导出操作后，就值得执行一次VACUUM。对于普通应用的小型数据库，这个过程通常只需要几秒；而大型数据库可能耗时较长，需要提前评估窗口时间。此外，配合PRAGMA optimize和ANALYZE语句一起使用，可以在整理空间的同时更新统计信息，让查询计划器获得更准确的数据分布，从而进一步优化查询性能。
总结来看，VACUUM是SQLite数据库维护中不可或缺的命令，它通过重建整个文件来回收空闲页、消除碎片。理解它的工作原理，结合auto_vacuum和增量回收机制，根据业务场景选择合适的策略，才能既保证数据库体积可控，又不影响线上服务的稳定性。
SQLite VACUUM数据库碎片整理SQLite空间回收修改时间：2026-09-02 03:40:29