48. 其他语言接口概览与生态

SQLite 之所以被称为”你已经在用的数据库”，一个重要原因是它几乎绑定了每一种主流语言。这是因为 SQLite 本身就是用 C 写的单个库，其它语言只要写一层”薄薄的包装”去调用它即可。再次强调它的定位：serverless（无服务进程）、零配置，数据库就是一个文件，任何语言拿到这个文件都能直接读写，不需要先启动服务器、不需要账号密码、不需要建连接池。这种”文件即数据库”的特性，是它跨语言通行的基础。

本章我们不对每种语言展开完整教程（那会违反”纯知识点、不堆实战”的定位），而是给你一张”地图”：知道各语言用哪个库、套路是什么，将来真要用时按图索骥即可。

一、通用套路：三种包装层

尽管语言各异，连接 SQLite 的姿势大致只有三类：

1. 原生 C 包装：比如 Python 的 sqlite3、Node 的 sqlite3 模块，底层都是直接调用 libsqlite3。性能最好、依赖最少。
2. JDBC / ADO.NET 等标准数据库接口驱动：Java 走 JDBC（如 sqlite-jdbc），C# 走 ADO.NET（如 Microsoft.Data.Sqlite）。它们把 SQLite 伪装成”普通关系型数据库”，让你用熟悉的标准 API 操作。
3. ORM / 查询构造器：像 Go 的 GORM、各类语言的 SQLAlchemy/Dapper。它们再包一层，让你用对象而不是 SQL 字符串。本章不建议初学者直接上 ORM——先把裸 SQL 写好，才懂 ORM 在替你做什么。

二、各语言速览

Java（JDBC） 现代做法是用 sqlite-jdbc（由 xerial 维护的 JDBC 驱动）这类驱动，它自带 Windows/macOS/Linux 的原生库。套路是 DriverManager.getConnection("jdbc:sqlite:文件.db") 拿到连接，再用 PreparedStatement 执行参数化 SQL。因为是标准 JDBC，你以前写 MySQL 的代码几乎能平移过来，只换连接串。

Node.js 最常见的是 sqlite3 模块，提供简洁的查询 API 并支持参数绑定；它还能串行或并行执行多条语句。值得留意：Node.js 从 22.5.0 起内置了实验性的官方 node:sqlite 模块（import('node:sqlite')），早期版本需带 --experimental-sqlite 启动标志；后续版本已移除该标志并进入”候选发布（release candidate）“阶段，但截至当前版本仍未正式稳定。因此生产环境目前仍以 better-sqlite3 这类成熟第三方库为主。

Go Go 社区常用 mattn/go-sqlite3 这类驱动（基于 cgo），配合 database/sql 标准库；若想避开 cgo，也有纯 Go 实现的 modernc.org/sqlite。套路是 sql.Open("sqlite3", "文件.db")，再用 db.Exec / db.Query 配合 ? 占位符读写。Go 的静态编译特性，让”带 SQLite 的单文件程序”分发特别方便。

C#（ADO.NET） 通过 Microsoft.Data.Sqlite 或 System.Data.SQLite，用 SqliteConnection 连接文件，SqliteCommand 执行 SQL。和 Java 类似，属于标准 ADO.NET 体系，事务用 BeginTransaction / Commit / Rollback 管理。

PHP PHP 提供两种扩展：PDO_SQLITE（统一的 PDO 接口，推荐）和 sqlite3（更直接的接口）。用 PDO 时连接串形如 new PDO("sqlite:文件.db")，同样用 ? 或 :name 做参数化。

三、现代生态工具：文件即数据的威力

“数据库是文件”这一特性，养活了一整套独特工具生态。这里介绍两个由 SQLite 布道者 Simon Willison 打造的代表：

sqlite-utils 一个 CLI + Python 库，专门用来”摆弄 SQLite 文件”。它能一行命令把 JSON/CSV 灌进数据库、自动建表、开全文检索。比如 sqlite-utils insert data.db table data.json 就能把 JSON 数组变成一张表。它让”把任意数据丢进 SQLite”变得极轻量，非常适合做数据清洗和临时分析。

Datasette 一个”用来探索和发布数据”的开源多工具。你只要 datasette 文件.db，它就启动一个网页界面，让你像浏览网站一样翻看、搜索、过滤 SQLite 数据，还能一键发布成在线站点。它的核心理念叫”baked data”——把整理好的数据”烘焙”进 SQLite 文件，直接当静态资源分发，无需后端。这对做公开数据集、内部报表非常友好。

四、类型亲和性的提醒

跨语言时还有一个坑要记牢：SQLite 是动态类型 + 类型亲和性（Type Affinity）。你声明列时写的 TEXT、INTEGER 等只是”亲和性建议”，实际存进去的**存储类（Storage Class）**由值本身决定——只有 5 种：NULL / INTEGER / REAL / TEXT / BLOB。没有 DATE、TIME、DATETIME、TIMESTAMP 这几种日期类型。所以不同语言写入”日期”时，约定俗称地用 TEXT 存 ISO8601 字符串、用 INTEGER 存 unix 秒、用 REAL 存儒略日，由日期函数去解析，而不是依赖某种”日期列类型”。各语言驱动都不会帮你自动转换日期类型，这正是亲和性体系与静态类型数据库的差异，切换语言时尤需留意。

四之二、何时用 SQLite、何时考虑别的

顺着”文件即数据库”的特性，能更清楚它的边界：适合单机、嵌入式、边缘设备、移动 App 本地存储、测试与数据分析原型——这些场景它几乎是最优解。但当你的需求变成高并发写入（很多进程同时写）、超大数据量（远超单文件合理容量）、或需要细粒度多用户权限与网络集中管理时，就该考虑 PostgreSQL / MySQL 这类客户端—服务器数据库。注意这不是”谁更强”，而是架构定位不同：SQLite 把”服务器”省掉了，换来极简部署；需要服务器那层能力时，自然要换工具。客观认识边界，比盲目崇拜或贬低都重要。

五、类比小结

把 SQLite 想象成一个”通用 U 盘”：C 是 U 盘本体，Python/Java/Go/C#/PHP 是不同品牌的读卡器，都能读同一张盘；而 sqlite-utils、Datasette 是插在盘上的”整理盒”和”展示屏”。正因为盘（文件）是中立的，你上午用 Python 写进去的数据，下午用 Node.js 读出来、用 Datasette 网页展示，完全无缝——这是 serverless、单文件架构独有的便利。下一章我们掀开这个”U 盘”的盖子，看看里面到底是怎么存数据的。