印刻数据库

外观

SQLite 在 Windows 上安装 ​

本文档详细介绍 SQLite 在 Windows 系统上的安装方法和配置步骤。

安装方法 ​

下载预编译二进制文件 ​

  1. 访问 SQLite 官方下载页面：https://www.sqlite.org/download.html

  2. 下载 Windows 预编译二进制文件，包括：

    • sqlite-tools-win32-x86-*.zip（命令行工具）
    • sqlite-dll-win32-x86-*.zip（动态链接库）

  3. 解压下载的文件到指定目录，例如 C:\sqlite

配置环境变量 ​

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到「Path」，点击「编辑」
  3. 点击「新建」，添加 C:\sqlite（根据实际解压目录调整）
  4. 点击「确定」保存设置

验证安装 ​

  1. 打开命令提示符（cmd）或 PowerShell
  2. 运行以下命令验证 SQLite 是否安装成功：
bash
sqlite3 --version

预期输出：

sqlite3 3.44.0 2023-11-01 11:23:50 93525403c12143aee0ff8a577399e94070845ebd9b9725354437d16569df19a5

使用方法 ​

启动 SQLite 命令行工具 ​

在命令提示符或 PowerShell 中运行：

bash
sqlite3

创建并连接数据库 ​

bash
sqlite3 mydatabase.db

版本差异与注意事项 ​

Windows 版本兼容性 ​

SQLite 预编译二进制文件适用于所有 Windows 版本，但需要注意以下几点：

Windows 版本兼容性注意事项
Windows 11完全兼容推荐使用最新版本
Windows 10完全兼容支持所有 SQLite 功能
Windows 8.1完全兼容支持所有 SQLite 功能
Windows 7兼容建议使用 SQLite 3.31.0 以上版本
Windows Server 2016+完全兼容推荐用于服务器环境
Windows Server 2012 R2兼容建议使用较新版本

32位与64位版本 ​

  • 32位版本：适用于所有 Windows 系统，包括32位和64位 Windows
  • 64位版本：仅适用于64位 Windows 系统，性能更好

生产环境安装建议 ​

  1. 选择合适的版本：生产环境建议使用最新稳定版
  2. 安装位置：建议安装到系统盘根目录，如 C:\sqlite，避免路径包含空格
  3. 环境变量配置：确保将 SQLite 安装目录添加到系统环境变量 Path 中
  4. 权限设置：确保数据库文件和安装目录具有适当的读写权限
  5. 定期更新：关注 SQLite 官方发布的安全更新和 bug 修复
  6. 备份安装文件：保存下载的安装包和校验和，便于审计和回滚

配置与优化 ​

环境变量配置 ​

除了将 SQLite 安装目录添加到 Path 外，还可以设置以下环境变量来优化 SQLite 行为：

batch
:: 设置默认缓存大小（KB）
setx SQLITE_DEFAULT_CACHE_SIZE 8192 /M

:: 设置默认页大小（字节）
setx SQLITE_DEFAULT_PAGE_SIZE 4096 /M

:: 设置默认日志模式
setx SQLITE_DEFAULT_JOURNAL_MODE WAL /M

Windows 特定优化 ​

  1. 使用 NTFS 文件系统：NTFS 对 SQLite 性能和可靠性有较好的支持
  2. 禁用索引服务：对 SQLite 数据库文件禁用 Windows 索引服务，避免性能问题
  3. 合理设置文件属性：确保数据库文件未设置为「只读」或「压缩」
  4. 考虑使用 SSD：SQLite 在 SSD 上性能更好
  5. 关闭防病毒实时扫描：对 SQLite 数据库文件目录关闭防病毒实时扫描，避免性能问题

安装后验证与测试 ​

基本功能测试 ​

batch
:: 创建测试数据库
sqlite3 test.db "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT);"

:: 插入测试数据
sqlite3 test.db "INSERT INTO users (name) VALUES ('Test User');"

:: 查询测试数据
sqlite3 test.db "SELECT * FROM users;"

扩展功能测试 ​

batch
:: 测试JSON功能
sqlite3 test.db "SELECT json('{\"name\": \"Test\"}');"

:: 测试WAL模式
sqlite3 test.db "PRAGMA journal_mode=WAL;"

性能测试 ​

batch
:: 插入大量数据测试性能
sqlite3 test.db "BEGIN TRANSACTION;"
for /l %%i in (1,1,1000) do sqlite3 test.db "INSERT INTO users (name) VALUES ('User %%i');"
sqlite3 test.db "COMMIT;"

常见问题（FAQ） ​

Q: 命令行中无法找到 sqlite3 命令怎么办？ ​

A: 请检查以下几点：

  1. 确认已将 SQLite 安装目录添加到系统环境变量 Path 中
  2. 确认已保存环境变量设置并重新打开命令提示符
  3. 尝试使用完整路径运行，如 C:\sqlite\sqlite3 --version
  4. 确认下载的文件已正确解压

Q: 如何在 Windows 上使用 SQLite GUI 工具？ ​

A: 推荐使用以下 GUI 工具：

  • DB Browser for SQLite：开源免费，功能全面，适合初学者
  • Navicat：商业化，功能强大，支持多种数据库
  • DBeaver：开源免费，支持多种数据库，适合开发人员
  • SQLite Expert：商业化，专注于 SQLite，功能丰富

Q: 如何升级 SQLite 到最新版本？ ​

A: 升级步骤如下：

  1. 从官方网站下载最新的预编译二进制文件
  2. 备份当前 SQLite 安装目录
  3. 停止所有使用 SQLite 的应用程序
  4. 替换旧版本的文件（sqlite3.exe、sqlite3.dll 等）
  5. 验证升级是否成功：sqlite3 --version

Q: 安装过程中遇到权限问题怎么办？ ​

A: 请尝试以下方法：

  1. 使用管理员权限运行命令提示符或 PowerShell
  2. 确保当前用户具有写入目标目录的权限
  3. 尝试将 SQLite 安装到其他目录，如用户目录
  4. 检查防病毒软件是否阻止了文件操作

Q: 如何在 PowerShell 中使用 SQLite？ ​

A: SQLite 可以直接在 PowerShell 中使用，命令与在 cmd 中相同：

powershell
# 查看版本
sqlite3 --version

# 创建数据库
sqlite3 test.db "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT);"

Q: 如何在 Visual Studio 项目中使用 SQLite？ ​

A: 在 Visual Studio 项目中使用 SQLite 的步骤：

  1. 安装 SQLite 相关 NuGet 包，如 System.Data.SQLite 或 Microsoft.Data.Sqlite
  2. 添加必要的 using 语句
  3. 使用提供的 API 进行 SQLite 操作

Q: 如何修复损坏的 SQLite 数据库？ ​

A: 可以尝试以下方法修复损坏的 SQLite 数据库：

batch
:: 方法1：使用 .recover 命令
sqlite3 corrupted.db ".recover" | sqlite3 fixed.db

:: 方法2：使用 PRAGMA integrity_check
sqlite3 corrupted.db "PRAGMA integrity_check;"

:: 方法3：使用 VACUUM 命令
sqlite3 corrupted.db "VACUUM INTO 'fixed.db';"

Q: 如何在 Windows 服务中使用 SQLite？ ​

A: 在 Windows 服务中使用 SQLite 需要注意以下几点：

  1. 确保服务运行的账户具有数据库文件的读写权限
  2. 使用绝对路径指定数据库文件位置
  3. 考虑使用 WAL 模式提高性能和可靠性
  4. 实现适当的错误处理和重试机制
  5. 定期备份数据库文件