多数现代linux发行版默认预装sqlite3，运行sqlite3 --version可验证；但开发需额外安装libsqlite3-dev（ubuntu/debian）或sqlite-devel（centos/rhel），否则c程序编译会因缺少sqlite3.h失败。
确认系统是否已自带 sqlite3
多数现代 Linux 发行版（如 Ubuntu 22.04+、Fedora、Debian）默认已预装 sqlite3，直接运行 sqlite3 --version 就能验证。若返回类似 3.37.2 的版本号，说明命令可用；但注意：这不等于能开发——sqlite3 命令行工具和 C API 头文件是两回事。
常见误判点：
- 执行
which sqlite3有输出 ≠ 能编译 C 程序；缺少libsqlite3-dev会导致#include <sqlite3.h></sqlite3.h>报错 - CentOS/RHEL 8+ 默认只带
sqlite3，但sqlite-devel需单独装：sudo yum install sqlite-devel - 某些最小化安装的嵌入式系统（如 Buildroot 或 Yocto 构建镜像）可能完全没装，需手动部署二进制或交叉编译
Ubuntu/Debian 安装 sqlite3 与开发依赖
如果 sqlite3 --version 报 command not found，用 apt 安装：
sudo apt update sudo apt install sqlite3 libsqlite3-dev
libsqlite3-dev 必须装，否则 C 程序编译会卡在 sqlite3.h: No such file or directory。Python 用户一般不用额外装（sqlite3 是标准库），但若要用 pysqlite3 升级版本，才需 pip 安装。
验证安装是否真正可用：
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 运行
sqlite3 test.db，看到sqlite>提示符才算成功打开数据库文件（不是只进命令行） - 若报
unable to open database file，检查当前目录是否有写权限，或改用绝对路径：sqlite3 /tmp/test.db - 退出用
.exit或.quit，别输exit（那是 shell 命令，不是 sqlite 元命令）
.tables 没输出？先看 .database 和分号有没有漏
.tables 是元命令，只显示当前打开的数据库中**已提交创建**的表。它不报错、不提示“空”，容易让人以为失效。
典型排查步骤：
- 输
.database，确认输出类似main: /path/to/test.db；若显示main: :memory:，说明你启动时没指定文件名，正在用内存数据库，退出重试：sqlite3 myapp.db - 建表语句必须以分号结尾：
CREATE TABLE users(id INTEGER, name TEXT);——漏掉;，语句只是缓存，不会执行，.tables当然看不到 -
.schema可验证表是否存在：如果有表，它会输出建表 SQL；如果空白，说明真没建成功 - 表名区分大小写（除非用双引号定义），但
.tables显示时不带引号，查的时候要严格匹配，比如CREATE TABLE "Log"，后续必须写SELECT * FROM "Log";
INSERT/SELECT 没反应？分号和点命令别混用
新手最常卡在这里：把 SQL 当成点命令，或者反过来。sqlite3 严格分离两类指令：
- 所有以
.开头的是 sqlite 自己的元命令（如.headers on、.mode column），**不加分号**，也不能跟在 SQL 后面连写 - 所有 SQL（
INSERT、SELECT、UPDATE）**必须以分号结尾**，否则光标停在下一行等待续写，看起来像“卡住” -
.headers on不开的话，SELECT返回纯数据，没有列名，容易误判为没结果；建议一进就执行它 - 插入后想确认是否成功，别只看提示，执行
SELECT COUNT(*) FROM users;再加分号
一个完整小流程示例：
sqlite3 app.db
sqlite> .headers on
sqlite> .mode column
sqlite> CREATE TABLE tasks(id INTEGER PRIMARY KEY, title TEXT);
sqlite> INSERT INTO tasks(title) VALUES ('learn sqlite');
sqlite> SELECT * FROM tasks;
真正容易被忽略的点是：sqlite3 没有“自动提交”概念——每个语句本身就是事务，但如果你在多行输入中漏了分号，整个交互就悬在那里，既不报错也不继续，得靠 Ctrl+C 中断。这种静默等待，在脚本或自动化场景里尤其危险。
