SQLite 文档的学习笔记（1）长期支持计划

翻译 2022年 8月 4日

系列： SQLite的测试方法

扫一扫，转发文章

先打个广告：欢迎关注我的公众号，参与 文史大挑战 趣味题目。使用方法见这篇文章。

正文开始：

前段时间偶然用了 sqlite，在阅读了文档后，感到 sqlite 背后是一个严谨、负责、专业的团队。通过阅读这些文档能学习到不少专业知识和精神。

这篇支持计划可以看做是今天的作者写给未来的参与者的信，讲述了过去和今天的做法，树立了今后 SQLite 的开发活动价值观和方法论。在我们的项目中，有值得学习的地方。

原始材料：Long Term Support，中文版：长期支持

正文

SQLite 开发者的意愿是：一直支持 SQLite 到 2050 年。

在编写本文的时候，距离 2050 年还有 34 年之遥，谁也不知道那时的世界会是什么样子。同时，我们也不能保证，在那么久远的将来，SQLite 仍然可以使用、抑或能不能运行。然而，我们今天作出保证：我们将按照我们能一直支持到 2050 年的假设去规划我们今天的开发活动，这个远期的目标指引着我们今天的价值取向，有如下几点：

跨平台兼容能力

SQLite 要能运行在具备以下条件的所有平台上：8比特长的字节、2补码的二进制、32位或64位、有C编译器。SQLite 针对当前流行的CPU和操作系统积极主动地开展测试。SQLite 自身代码和使用的文件格式具备极高的可移植性，这将保证它在未来仍可以运行。

稳定的、多个平台一致的数据文件

SQLite 保存数据的文件能在 32-bit、64-bit、大端字节、小端字节等各种平台下，做到逐个 bit 的相同。这意味着你从一种平台拷贝数据文件到另一种平台后，不需要转换数据文件格式就能直接读取和运行。而且，数据文件的格式有着详尽而又稳定的文档。几十年后的 SQLite 仍然可以直接读写今天创建的数据文件。

航空级的软件测试过程

SQLite 程序的每一条机器码的分支指令都从两个方向、反复多次、多种平台、多种编译器的完备测试这是乘法关系，假设有10万个测试场景、5次、5种平台、5种编译器，完整的测试次数将是：10万×5×5×5=1250万次测试。这样做的目的是让代码保持健壮，不易出错，以备未来的各种迁移重构。另外，严格充分的测试，还能让后继要为后代考虑，现在维护这套代码的人，到 2050 年还有几个能写？的开发者敢于编写一些具有试验性的新功能，待这些新功能发布后，如果以往的测试集在新代码上都能通过，我们能有理由的认为，至少所有的旧功能仍然正常工作。

丰富、详尽的文档

SQLite 的文档内容诚恳、坦率、对开发者友好、源代码开放。这些文档从程序员中来、到程序员中去，让后继的开发者能迅速的融入 SQLite 的开发过程中。

附：文档的示范

大量的代码注释

SQLite 源代码中，注释占到了 35% 以上。而且这些注释都不是言之无物，反而是大有用处。这些注释的内容包括代码中变量和对象的含义、函数方法的设计意图等。这些代码旨在让新加入的程序员能够无压力的阅读，并且能在数十年的跨度内方便维护，而不至于烂到无从下手。

防范灾难

SQLite 源代码的每次更新记录的每个字节都被加密保存，而且被自动地备份在多个数据中心上，这些数据中心不仅在地理空间防天灾上分隔，而且还分属于不同的公司避人祸。此外，还有数以千计的代码备份在世界各地的私有服务器上。SQLite 的主要开发者生活在世界各地。所以即使地球少了一块比如行星撞地球，也不会影响到 SQLite。