SQLite 数据库安装配置：几乎零依赖的数据库

SQLite 安装配置：几乎零依赖的数据库

SQLite 最大的特点就是不需要复杂的安装配置。与需要独立服务器进程的 MySQL、PostgreSQL 不同，SQLite 直接嵌入到你的应用程序中运行。这意味着你不需要专门的数据库服务器、不需要配置端口、不需要设置用户权限——数据库就是一个普通的文件。

🎯 核心结论：SQLite 需要什么环境？

一句话总结：SQLite 几乎可以在任何操作系统上运行，不需要额外安装数据库服务器，不依赖外部库。

📁 三种安装配置方式

1. Windows 安装（预编译二进制文件）

这是 Windows 下最直接的安装方式，只需下载文件并配置环境变量。

第一步：下载文件

访问 SQLite 官网下载页面（SQLite Download Page），下载这两个文件：

• sqlite-tools-win32-x64-*.zip（命令行工具）

• sqlite-dll-win64-x64-*.zip（动态链接库）

第二步：解压并配置

cmd

# 1. 创建文件夹（路径建议不含中文和空格）
mkdir C:\sqlite

# 2. 将两个压缩包解压到 C:\sqlite
# 解压后会得到：sqlite3.exe、sqlite3.dll、sqlite3.def

第三步：配置环境变量

cmd

# 1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
# 2. 在"系统变量"中找到 Path → 编辑 → 新建
# 3. 添加 C:\sqlite
# 4. 点击确定保存[citation:8]

第四步：验证安装

cmd

# 打开新的命令提示符窗口
sqlite3 --version
# 应输出：3.x.x 2025-...

2. Linux / macOS 安装（包管理器）

Ubuntu / Debian：

bash

# 安装 sqlite3 命令行工具
sudo apt-get install sqlite3

# 安装开发库（供 C/C++ 程序调用）
sudo apt-get install libsqlite3-dev

macOS：

bash

brew install sqlite3

验证安装：

bash

sqlite3 --version

3. Python 中使用（无需单独安装）

如果你只是通过 Python 使用 SQLite，完全不需要上面的安装步骤——Python 标准库自带 sqlite3 模块。

python

import sqlite3
print(sqlite3.sqlite_version)  # 查看 SQLite 版本

# 直接连接数据库文件（不存在会自动创建）
conn = sqlite3.connect('mydatabase.db')

这也意味着，当你把 Python 项目部署到服务器时，只要目标机器有 Python，SQLite 就可以直接使用，无需任何额外配置。

🐍 Python 项目中使用 SQLite

根据之前的对话历史，你正在开发 Python + Flask + Nginx + SQLite 的网站。在 Python 中使用 SQLite 非常简单：

python

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)

# 配置 SQLite 数据库路径
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///instance/app.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

db = SQLAlchemy(app)

# 定义模型
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)

# 创建数据库文件（首次运行自动创建）
with app.app_context():
    db.create_all()

这种配置方式：

• 数据库文件会保存在 instance/app.db

• 首次运行 Flask 应用时会自动创建数据库文件

• 无需单独启动任何数据库服务

🔧 SQLite 配置文件（可选）

SQLite 的运行时配置主要通过 PRAGMA 语句在连接时设置，而不是通过独立的配置文件。

python

import sqlite3

conn = sqlite3.connect('app.db')
# 启用 WAL 模式（提高并发性能）
conn.execute('PRAGMA journal_mode=WAL')
# 设置缓存大小（20MB）
conn.execute('PRAGMA cache_size=-20000')
# 设置同步模式（平衡性能与安全）
conn.execute('PRAGMA synchronous=NORMAL')
# 设置超时时间
conn.execute('PRAGMA busy_timeout=5000')

注意：之前提到过 SQLite 在 Linux 下可能有 /etc/sqlite3/sqlite3.conf 这样的系统级配置文件，但在 Windows 环境下并不常见，也非必需。绝大多数配置在应用代码中完成即可。

📊 各平台配置速查

特殊情况——嵌入式系统交叉编译：

如果你的目标环境是嵌入式 Linux 设备（如 ARM 开发板），且设备上原本没有 SQLite，则需要从源码进行交叉编译：

bash

# 下载源码
wget https://www.sqlite.org/2024/sqlite-autoconf-3450100.tar.gz
tar zxvf sqlite-autoconf-*.tar.gz
cd sqlite-autoconf-*

# 配置交叉编译（以 ARM64 为例）
./configure --host=aarch64-linux-gnu --prefix=/usr/local/sqlite
make
make install

但对于你目前的项目（Windows 10 + Python + Flask），完全不需要走这条路。

✅ 总结

对于你正在开发的 Python + Flask + Nginx + SQLite 网站，SQLite 的安装配置极其简单：

1. Windows 环境：下载两个压缩包 → 解压到文件夹 → 配置 PATH 环境变量 → 完成

2. Python 使用：import sqlite3 即可，无需任何额外安装

3. 无需配置文件：运行时参数通过 PRAGMA 语句在代码中设置

这也是为什么 SQLite 被称为“零配置数据库”——你不需要像 MySQL 那样安装数据库服务、配置端口、创建用户、设置权限。它就是一个文件，用代码直接操作即可。