安装 SQLite 与环境验证
本教程共 50 篇 · 第 4 篇 · 更新于 2026-07-31
04. 安装 SQLite 与环境验证
本节目标:学完本章你能在自己电脑上装好
sqlite3命令行工具,并敲出sqlite3 --version看到版本号,确认环境就绪。
前面几章都在讲概念,这一章动手。我们要装的是 sqlite3 命令行工具(CLI)——它是 SQLite 官方提供的、用来在终端里直接操作数据库文件的小程序。装好它,你就能跟着后面所有章节敲命令了。
Note本教程以 SQLite 3.53.4(2026-07-24) 为基线版本。你装到的具体版本号可能略新或略旧,只要是大版本 3.x,命令和语法都通用。注意区分两个概念:“SQLite 库”(被编进程序的引擎代码)和 “sqlite3 CLI”(你这里要装的命令行工具)——本章装的是后者。
先确认:说不定你已经有了
很多系统(尤其 macOS、大部分 Linux 发行版)出厂就带了 sqlite3。先别急着下载,打开终端敲一下:
sqlite3 --version
如果看到类似下面的输出,说明已经装好,直接跳到本章最后一节“验证环境”即可:
SQLite version 3.53.4 2026-07-24 18:36:39
如果提示“command not found / 不是内部或外部命令”,再按下面你的系统来装。
Windows 上安装
方式一:下载官方预编译二进制(最通用)
- 打开浏览器访问 SQLite 官网下载页
https://www.sqlite.org/download.html。 - 在 Precompiled Binaries for Windows 区域,下载两个 zip:
sqlite-tools-win-x64-*.zip(命令行工具,含sqlite3.exe)sqlite-dll-win-x64-*.zip(动态链接库sqlite3.dll)
- 在
C:盘新建文件夹C:\sqlite,把上面两个压缩包解压进去,你会得到sqlite3.exe、sqlite3.dll、sqlite3.def等文件。 - 把
C:\sqlite加进系统 PATH 环境变量(设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 在“Path”里新增一条C:\sqlite)。 - 重新打开一个命令提示符(旧的不会刷新 PATH),敲
sqlite3 --version验证。
示意操作(解压后进入目录运行):
C:\> cd C:\sqlite
C:\sqlite> sqlite3 --version
SQLite version 3.53.4 2026-07-24 18:36:39
方式二:用包管理器(更省心)
如果你装了 Chocolatey 或 Scoop,一行命令即可:
# Chocolatey
choco install sqlite
# Scoop
scoop install sqlite
TipWindows 用户强烈推荐用 Scoop/Chocolatey 装,它会自动帮你配好 PATH,省去手动设置环境变量的麻烦,以后升级也只是一行命令。
Linux 上安装
现在几乎所有 Linux 发行版都自带 SQLite。先验证:
sqlite3 --version
若没有,用系统包管理器装(最干净):
# Debian / Ubuntu 系
sudo apt update
sudo apt install sqlite3
# Red Hat / CentOS / Fedora 系
sudo dnf install sqlite
# Arch 系
sudo pacman -S sqlite
装完再敲 sqlite3 --version 确认。
如果你需要最新版或交叉编译,也可以从源码装:到下载页取 sqlite-autoconf-*.tar.gz,解压后 ./configure && make && sudo make install。但对初学者,包管理器足够。
macOS 上安装
新版 macOS 通常已经预装了 sqlite3,先验证:
sqlite3 --version
如果没有(或你想用更新的版本),推荐用 Homebrew:
brew install sqlite
装完后如果 sqlite3 --version 仍显示系统旧版,多半是 PATH 优先级问题,可运行 brew info sqlite 按提示把 brew 的 sqlite 路径加到 shell 配置(如 ~/.zshrc)的前面。
验证环境:确认装对了
不管哪种系统,最终都用同一句话验证:
sqlite3 --version
正常输出形如:
SQLite version 3.53.4 2026-07-24 18:36:39
这行信息从左到右分别是:版本号、发布日期、以及编译信息。只要能打印出来,说明 sqlite3 已经能被系统找到、可以正常启动,你的环境就就绪了。
你也可以不接任何参数直接敲 sqlite3 回车,会进入交互模式:
$ sqlite3
SQLite version 3.53.4 2026-07-24 18:36:39
Enter ".help" for usage hints.
Connected to a transient in-memory database.
Use ".open FILENAME" to reopen on a persistent database.
sqlite>
看到 sqlite> 提示符就成功了——输入 .quit 可退出。注意上面那句 Connected to a transient in-memory database,它提醒你:不带文件名启动时,连的是一块内存临时库,退出就没了。下一章我们专门讲 CLI 怎么用。
Warning两个常见“装了却用不了”的坑:① PATH 没生效——Windows 改完环境变量后必须重开终端,否则老的终端窗口找不到新加的命令;② 下载错了包——Windows 一定要选
sqlite-tools-*而不是只有sqlite-dll-*,后者只含运行库、不含sqlite3.exe命令行程序。遇到“命令不存在”先回头检查这两点。
版本号怎么读
sqlite3 --version 打印的那一行,信息量其实不小:
SQLite version 3.53.4 2026-07-24 18:36:39
3.53.4是 SQLite 库版本:主版本3代表 SQLite 第三版(也就是现在所有人用的这一代,动态类型、类型亲和性那一套都从 3.x 开始)。2026-07-24是发布日期。- 末尾的编译信息(如
UTF-16 console I/O、gcc等)说明这个二进制是怎么编出来的,日常不用管。
知道版本号有两个实际用处:一是确认你用的是较新的 3.x,能用到 json1、FTS5 等现代能力;二是出问题时,别人让你“贴出版本号”你能立刻给出来。
常见安装问题与排查
装数据库工具,坑往往不在“下载”而在“系统找不到命令”。按下面顺序自查:
- 敲
sqlite3提示“不是内部或外部命令”/“command not found”- Windows:多半是 PATH 没加或没生效。确认
C:\sqlite在 Path 里,并且重开了终端。 - macOS/Linux:确认包真的装成功了(
brew list sqlite/which sqlite3看路径);macOS 若仍显示系统旧版,把 brew 路径放到 shell 配置前面再开新终端。
- Windows:多半是 PATH 没加或没生效。确认
sqlite3 --version能跑,但双击sqlite3.exe一闪而过- 这是正常的。命令行程序没有图形窗口,必须在终端里运行;直接双击会因“跑完就关”而一闪即逝。用
cmd或 PowerShell 进入目录再敲sqlite3。
- 这是正常的。命令行程序没有图形窗口,必须在终端里运行;直接双击会因“跑完就关”而一闪即逝。用
- 下载页挑花眼,不知道下哪个
- Windows 选带
sqlite-tools的包(才有sqlite3.exe),不是只有sqlite-dll。 - 注意区分 32 位(x86)与 64 位(x64),现在绝大多数机器选 x64。
- Windows 选带
- 杀毒软件拦截
- 极少数情况下解压/运行会被安全软件误报,把
C:\sqlite加进白名单即可。
- 极少数情况下解压/运行会被安全软件误报,把
装好之后,下一步做什么
环境就绪后,你手里有了 sqlite3 这个“数据库终端”。但光装好还不够——你还没真正建过一张表、插过一条数据。下一章我们就用这个 CLI 打开一个库文件,学会用 .help、.tables、.schema、.mode、.headers 把数据库“看个明白”,正式迈出操作 SQLite 的第一步。
Tip建议把
sqlite3所在目录记在便签上(Windows 一般是C:\sqlite)。以后写脚本、做自动化、或教别人时,知道可执行文件在哪能省不少事。
可选:图形界面工具
命令行用熟了其实最顺手,但如果你想要图形界面,推荐两款免费工具:
- DB Browser for SQLite:开源、跨平台,能可视化建表、浏览数据、执行 SQL。
- SQLiteStudio:免费、便携、跨平台,支持 CSV/JSON/XML 导入导出。
它们本质都是调用 SQLite 库来读写 .db 文件,和你装的 sqlite3 CLI 操作的是同一种数据库,互不冲突。
类比小结
装 SQLite 和装别的软件不太一样:它几乎不用“装”。大多数系统自带;即使手动装,Windows 也就是解压一个文件夹、加个 PATH,Linux/macOS 一行包管理命令搞定。这正好呼应第一章说的“零配置”——你甚至可以把 sqlite3.exe 直接丢进 project 目录里就能用,完全不需要“安装服务”那一套。
环境既然就绪,下一章我们就正式进入 sqlite3 命令行,学会用 .help、.tables、.schema、.mode、.headers 这些点命令把数据库“看个明白”。
Tip把
sqlite3 --version的输出截图或记下来,以后遇到命令行为异常时,先确认版本,能帮你快速判断是不是“版本太旧导致某功能不支持”。