Linux下安装SQLite3及使用教程

本文详细解析了Linux系统中SQLite 3的安装与基础操作要点，既澄清了“预装sqlite3命令行工具≠具备C语言开发能力”这一常见误区，强调必须额外安装对应开发包（如libsqlite3-dev或sqlite-devel）才能编译含SQLite API的程序，又手把手指导用户规避高频陷阱：从正确验证安装、区分点命令与SQL语句、严格使用分号终止、启用.headers和.mode提升可读性，到排查.tables无输出、INSERT无响应、数据库路径权限等问题，覆盖从环境搭建到交互式开发的完整链路，尤其适合刚接触SQLite的Linux开发者快速避坑、高效上手。

确认系统是否已自带 sqlite3

多数现代 Linux 发行版（如 Ubuntu 22.04+、Fedora、Debian）默认已预装 sqlite3，直接运行 sqlite3 --version 就能验证。若返回类似 3.37.2 的版本号，说明命令可用；但注意：这不等于能开发——sqlite3 命令行工具和 C API 头文件是两回事。

常见误判点：

• 执行 which sqlite3 有输出 ≠ 能编译 C 程序；缺少 libsqlite3-dev 会导致 #include 报错
• 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 安装。

验证安装是否真正可用：

• 运行 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 中断。这种静默等待，在脚本或自动化场景里尤其危险。

好了，本文到此结束，带大家了解了《Linux下安装SQLite3及使用教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！