首页 / SQLite 入门教程 / 安装 SQLite 与环境验证

SQLite 入门教程

安装 SQLite 与环境验证

本教程共 50 篇 · 第 4 篇 · 更新于 2026-07-31

sqlite安装sqlite3cli

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 上安装

方式一:下载官方预编译二进制(最通用)

  1. 打开浏览器访问 SQLite 官网下载页 https://www.sqlite.org/download.html
  2. Precompiled Binaries for Windows 区域,下载两个 zip:
    • sqlite-tools-win-x64-*.zip(命令行工具,含 sqlite3.exe
    • sqlite-dll-win-x64-*.zip(动态链接库 sqlite3.dll
  3. C: 盘新建文件夹 C:\sqlite,把上面两个压缩包解压进去,你会得到 sqlite3.exesqlite3.dllsqlite3.def 等文件。
  4. C:\sqlite 加进系统 PATH 环境变量(设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 在“Path”里新增一条 C:\sqlite)。
  5. 重新打开一个命令提示符(旧的不会刷新 PATH),敲 sqlite3 --version 验证。

示意操作(解压后进入目录运行):

C:\> cd C:\sqlite
C:\sqlite> sqlite3 --version
SQLite version 3.53.4 2026-07-24 18:36:39

方式二:用包管理器(更省心)

如果你装了 ChocolateyScoop,一行命令即可:

# Chocolatey
choco install sqlite

# Scoop
scoop install sqlite
Tip

Windows 用户强烈推荐用 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.4SQLite 库版本:主版本 3 代表 SQLite 第三版(也就是现在所有人用的这一代,动态类型、类型亲和性那一套都从 3.x 开始)。
  • 2026-07-24发布日期
  • 末尾的编译信息(如 UTF-16 console I/Ogcc 等)说明这个二进制是怎么编出来的,日常不用管。

知道版本号有两个实际用处:一是确认你用的是较新的 3.x,能用到 json1、FTS5 等现代能力;二是出问题时,别人让你“贴出版本号”你能立刻给出来。

常见安装问题与排查

装数据库工具,坑往往不在“下载”而在“系统找不到命令”。按下面顺序自查:

  1. sqlite3 提示“不是内部或外部命令”/“command not found”
    • Windows:多半是 PATH 没加或没生效。确认 C:\sqlite 在 Path 里,并且重开了终端
    • macOS/Linux:确认包真的装成功了(brew list sqlite / which sqlite3 看路径);macOS 若仍显示系统旧版,把 brew 路径放到 shell 配置前面再开新终端。
  2. sqlite3 --version 能跑,但双击 sqlite3.exe 一闪而过
    • 这是正常的。命令行程序没有图形窗口,必须在终端里运行;直接双击会因“跑完就关”而一闪即逝。用 cmd 或 PowerShell 进入目录再敲 sqlite3
  3. 下载页挑花眼,不知道下哪个
    • Windows 选带 sqlite-tools 的包(才有 sqlite3.exe),不是只有 sqlite-dll
    • 注意区分 32 位(x86)与 64 位(x64),现在绝大多数机器选 x64。
  4. 杀毒软件拦截
    • 极少数情况下解压/运行会被安全软件误报,把 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 的输出截图或记下来,以后遇到命令行为异常时,先确认版本,能帮你快速判断是不是“版本太旧导致某功能不支持”。