安装 SQLite：Windows、macOS 与 Linux 安装教程

你的电脑上可能已经有 SQLite 了

安装之前，先看看你已经有什么。macOS 和大多数 Linux 发行版都自带 SQLite，它还内置在你每天使用的无数应用中。打开终端，运行：

sqlite3 --version

如果你看到类似 3.43.2 2023-10-10 ... 的内容，那就搞定了：直接跳到本页底部的验证部分。如果提示 command not found，或者版本低于 3.35，就继续往下读。我们会依次介绍 Windows、macOS 和 Linux。

你要安装的是 sqlite3 命令行工具。程序链接的库是一个单独的包，但大多数安装方式会把它们打包在一起。

Windows：下载并加入 PATH

Windows 不自带 SQLite，也没有传统意义上的安装程序：SQLite 以一个小压缩包的形式发布，里面是几个可执行文件，你想放在哪里都行。

1. 打开 sqlite.org/download.html。
2. 在 Precompiled Binaries for Windows 下，下载名为 sqlite-tools-win-x64-*.zip 的文件。
3. 把它解压到一个文件夹中。C:\sqlite 是常见的选择。
4. 把这个文件夹加入 PATH，这样你就能在任意目录下运行 sqlite3。

加入 PATH 的方法：打开“开始”菜单，搜索“环境变量”，点击编辑系统环境变量，再点击环境变量...，在用户变量中找到 Path，点击编辑，然后把 C:\sqlite 添加为新的一项。

打开一个新的终端窗口（PATH 的修改不会作用于已经打开的终端），然后验证：

sqlite3 --version

你应该会看到版本信息。如果提示 'sqlite3' is not recognized，说明这个文件夹不在 PATH 中，或者新终端还没有读取到这个修改。

macOS：用 Homebrew 安装最新版本

macOS 自带 sqlite3，但系统版本比官方最新版落后一两年。用来跟着教程学习或者日常使用都没问题。如果你想用较新的功能（STRICT 表、JSON 改进、更好的窗口函数），就用 Homebrew 安装最新版本：

brew install sqlite

Homebrew 把 SQLite 安装在它自己的目录下，并且有意不覆盖系统自带的版本。要默认使用 Homebrew 的版本，就把它加到 PATH 的最前面。在你的 ~/.zshrc 中添加：

export PATH="/opt/homebrew/opt/sqlite/bin:$PATH"

（在 Intel 芯片的 Mac 上，改用 /usr/local/opt/sqlite/bin。）用 source ~/.zshrc 重新加载 shell，然后检查：

sqlite3 --version

如果版本看起来还是旧的，说明系统的 sqlite3 在 PATH 中排在了前面：仔细检查这行 export 是否写在其他 PATH 修改之前。

Linux：使用包管理器

几乎所有 Linux 发行版的默认软件源中都有 SQLite。命令因发行版而异：

# Debian, Ubuntu, Mint
sudo apt update
sudo apt install sqlite3

# Fedora, RHEL, CentOS Stream
sudo dnf install sqlite

# Arch, Manjaro
sudo pacman -S sqlite

# Alpine
sudo apk add sqlite

在 Debian 系的系统上，包名是 sqlite3；在大多数其他系统上，包名就是 sqlite。它们都会安装 sqlite3 命令行工具，以及其他程序用来嵌入 SQLite 的共享库。

如果你需要最新的版本，而发行版的版本比较旧，可以从源码构建：从 sqlite.org 下载 amalgamation 源码包，然后运行 ./configure && make && sudo make install。对 99% 的用户来说，包管理器里的版本就够用了。

验证安装

无论你用的是哪种方式，同样的两步检查就能告诉你一切是否正常。首先是版本：

sqlite3 --version

你应该会看到版本号、日期和构建哈希。然后不带任何参数打开 SQLite shell，这会给你一个可以随便试的内存数据库：

sqlite3

你会看到一个类似 sqlite> 的提示符。输入一条小查询，确认引擎真的能运行：

SELECT sqlite_version(), 'Hello from SQLite' AS greeting;

你应该会得到版本信息和问候语。要退出 shell，输入 .quit 并按回车。开头的点很重要：SQLite 正是靠它来区分 shell 命令（.quit、.help、.tables）和 SQL 语句。

常见问题

第一次安装时，有几件事经常让人卡住：

• 安装后提示 sqlite3: command not found。 可执行文件已经在某个地方了，但不在 PATH 中。在 Windows 上，重新检查环境变量。在使用 Homebrew 的 macOS 上，确认 export PATH=... 这一行已经写进了 shell 配置文件，并且你打开的是一个新的终端。
• macOS 上显示的版本不对。 系统的 sqlite3 位于 /usr/bin/sqlite3，默认几乎总是它优先。运行 which sqlite3 查看 shell 选用的是哪一个。Homebrew 的版本需要在 PATH 中排得更靠前。
• .quit 不起作用。 你可能输入了不带点的 quit，SQLite 会试图把它当作 SQL 来解析。shell 命令一定要以 . 开头。
• 创建数据库文件时提示没有写入权限。 SQLite 需要对运行它的目录有写入权限。要么先 cd 到一个可写的目录，要么传入一个明确的路径：sqlite3 ~/mydb.db。

如果 sqlite3 --version 能用，你也能运行一条 SELECT，那就准备好了。本教程接下来的所有内容，都建立在你刚刚安装的命令行工具之上。

下一篇：SQLite 命令行工具

现在 sqlite3 已经在 PATH 中了，下一步是学会使用它。这个 shell 有一小组点命令（.tables、.schema、.mode、.import），能把它变成一个出奇强大的数据库客户端：这就是下一页的内容。