多数现代Linux发行版默认预装sqlite3,运行sqlite3 --version可验证;但开发需额外安装libsqlite3-dev(Ubuntu/Debian)或sqlite-devel(CentOS/RHEL),否则C程序编译会因缺少sqlite3.h失败。
多数现代 Linux 发行版(如 Ubuntu 22.04+、Fedora、Debian)默认已预装 sqlite3,直接运行 sqlite3 --version 就能验证。若返回类似 3.37.2 的版本号,说明命令可用;但注意:这不等于能开发——sqlite3 命令行工具和 C API 头文件是两回事。
常见误判点:
which sqlite3 有输出 ≠ 能编译 C 程序;缺少 libsqlite3-dev 会导致 #include <sqlite3.h> 报错sqlite3,但 sqlite-devel 需单独装:sudo yum install sqlite-devel
如果 sqlite3 --version 报 command not found,用 apt 安装:
sudo apt updatesudo apt install sqlite3 libsqlite3-dev
libsqlite3-dev 必须装,否则 C 程序编译会卡在 sqlite3.h: No such file or directory。Python 用户一般不用额外装(sqlite3 是标准库),但若要用 pysqlite3 升级版本,才需 pip 安装。
验证安装是否真正可用:
sqlite3 test.db,看到 sqlite> 提示符才算成功打开数据库文件(不是只进命令行)unable to open database file,检查当前目录是否有写权限,或改用绝对路径:sqlite3 /tmp/test.db
.exit 或 .quit,别输 exit(那是 shell 命令,不是 sqlite 元命令).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";
新手最常卡在这里:把 SQL 当成点命令,或者反过来。sqlite3 严格分离两类指令:
. 开头的是 sqlite 自己的元命令(如 .headers on、.mode column),**不加分号**,也不能跟在 SQL 后面连写INSERT、SELECT、UPDATE)**必须以分号结尾**,否则光标停在下一行等待续写,看起来像“卡住”.headers on 不开的话,SELECT 返回纯数据,没有列名,容易误判为没结果;建议一进就执行它SELECT COUNT(*) FROM users; 再加分号一个完整小流程示例:
sqlite3 app.dbsqlite> .headers onsqlite> .mode columnsqlite> CREATE TABLE tasks(id INTEGER PRIMARY KEY, title TEXT);sqlite> INSERT INTO tasks(title) VALUES ('learn sqlite');sqlite> SELECT * FROM tasks;
真正容易被忽略的点是:sqlite3 没有“自动提交”概念——每个语句本身就是事务,但如果你在多行输入中漏了分号,整个交互就悬在那里,既不报错也不继续,得靠 Ctrl+C 中断。这种静默等待,在脚本或自动化场景里尤其危险。