SQLite 创建数据库（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言：SQLite 数据库的轻量级魅力

在数字化时代，数据管理是应用程序开发的核心任务之一。SQLite 作为一款嵌入式数据库引擎，凭借其轻量、无需配置和跨平台的优势，成为许多开发者入门数据库的首选工具。无论是快速原型开发，还是为移动应用提供本地数据存储，SQLite 都能以极低的学习成本满足需求。然而，对于编程新手而言，如何从零开始“创建数据库”并构建数据模型，往往是第一个需要跨越的门槛。

本文将通过循序渐进的讲解，带您理解 SQLite 数据库的核心概念，并掌握通过命令行工具和编程语言（如 Python）创建数据库的实战技巧。无论是需要快速上手的初学者，还是希望系统化知识的中级开发者，都能在本文中找到适合自己的学习路径。

一、SQLite 数据库的基础概念：从图书馆到数字世界

1.1 数据库的比喻：图书馆的数字化

想象一个图书馆：书籍按照分类（如小说、科技、历史）分门别类地存放，每本书都有书名、作者、ISBN 等属性。SQLite 数据库正是将这种逻辑结构数字化：

• 数据库（Database）：相当于整个图书馆，包含多个“分类区域”（即表）。
• 表（Table）：每个分类区域，例如“小说表”或“用户表”。
• 字段（Column）：表中的每一列，如“书名”或“出版日期”。
• 记录（Row）：表中的一行数据，对应一本具体的书。

SQLite 的设计目标，就是让开发者像管理图书馆一样，高效地组织和检索数据。

1.2 SQLite 的核心特性

SQLite 的轻量级特性体现在：

• 无需服务端：直接通过文件系统操作数据库，无需安装独立的数据库服务器。
• 跨平台兼容：支持 Windows、Linux、macOS 等主流操作系统。
• ACID 兼容性：保证事务的原子性、一致性、隔离性和持久性，适合关键业务场景。

二、如何使用 SQLite 创建数据库：两种主流方式

2.1 方法一：命令行工具操作

SQLite 提供了命令行工具 sqlite3，适合快速测试或脚本开发。

步骤 1：安装 SQLite

大多数操作系统已预装 SQLite，若未安装可通过以下方式获取：

• Windows：下载官方二进制文件（SQLite 官网 ）。
• macOS/Linux：通过终端执行 brew install sqlite3（macOS）或 sudo apt-get install sqlite3（Ubuntu）。

步骤 2：创建数据库文件

打开终端，输入以下命令：

sqlite3 my_database.db  

此时，SQLite 会自动创建名为 my_database.db 的文件（若不存在），并进入交互式命令行界面。

步骤 3：创建表结构

在命令行中输入 SQL 语句：

CREATE TABLE users (  
    id INTEGER PRIMARY KEY AUTOINCREMENT,  
    name TEXT NOT NULL,  
    email TEXT UNIQUE,  
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP  
);  

这条语句创建了一个 users 表，包含用户 ID、姓名、邮箱和创建时间字段。

实际案例：创建图书管理数据库

CREATE TABLE books (  
    book_id INTEGER PRIMARY KEY,  
    title TEXT NOT NULL,  
    author TEXT,  
    category TEXT,  
    price REAL CHECK (price >= 0)  
);  

通过 CHECK 约束确保价格字段的合理性。

2.2 方法二：编程语言接口（以 Python 为例）

通过 Python 的 sqlite3 模块，可以更灵活地集成数据库操作到应用程序中。

步骤 1：导入模块并连接数据库

import sqlite3  

conn = sqlite3.connect('my_app.db')  
cursor = conn.cursor()  

步骤 2：执行 SQL 命令创建表

cursor.execute('''  
CREATE TABLE IF NOT EXISTS products (  
    product_id INTEGER PRIMARY KEY,  
    name TEXT NOT NULL,  
    price REAL,  
    stock INTEGER DEFAULT 0  
);  
''')  

conn.commit()  
conn.close()  

扩展案例：使用上下文管理器简化代码

with sqlite3.connect('inventory.db') as conn:  
    cursor = conn.cursor()  
    cursor.execute('''  
    CREATE TABLE orders (  
        order_id TEXT PRIMARY KEY,  
        customer_id INTEGER,  
        total REAL,  
        FOREIGN KEY (customer_id) REFERENCES customers(id)  
    );  
    ''')  

通过 FOREIGN KEY 实现表间关联，提升数据一致性。

三、数据库设计最佳实践

3.1 数据类型选择：避免“万能 TEXT”陷阱

SQLite 支持 INTEGER, REAL, TEXT, BLOB 等类型，但其灵活的无类型系统（type affinity）允许字段存储任意数据。例如：

• 优先使用 INTEGER 存储数值，避免因类型转换导致的精度问题。
• 用 DATETIME 或 TIMESTAMP 标记时间字段，便于后续排序和计算。
• 为文本字段指定 UNIQUE 或 NOT NULL 约束，确保数据规范性。

3.2 索引优化：加速查询的“导航地图”

索引如同图书索引，能快速定位数据。但需注意：

CREATE INDEX idx_email ON users (email);  

此语句为 users 表的 email 字段创建索引，可显著提升 WHERE email = ... 类查询的速度。

3.3 事务管理：保护数据一致性

在批量操作中使用事务，避免因中断导致数据不完整：

try:  
    with sqlite3.connect('bank.db') as conn:  
        conn.execute("BEGIN TRANSACTION;")  
        conn.execute("UPDATE accounts SET balance = balance - 100 WHERE id = 1;")  
        conn.execute("UPDATE accounts SET balance = balance + 100 WHERE id = 2;")  
        conn.commit()  
except Exception as e:  
    conn.rollback()  

通过 BEGIN TRANSACTION 和 COMMIT 确保操作的原子性。

四、常见问题与解决方案

4.1 问题 1：数据库文件未创建

现象：执行命令后未发现 .db 文件。
原因：路径错误或权限不足。
解决方案：

• 检查当前工作目录是否可写入。
• 明确指定绝对路径，例如 sqlite3 /home/user/data.db。

4.2 问题 2：字段名冲突或语法错误

现象：执行 CREATE TABLE 报错 near "..." syntax error。
原因：字段名使用保留字（如 ORDER）或未正确转义。
解决方案：

• 避免使用 SQL 关键字（如 SELECT, WHERE）作为字段名。
• 对特殊名称用反引号包裹：CREATE TABLE orders (`order\ TEXT);`

4.3 问题 3：版本升级导致兼容性问题

现象：旧代码在新版 SQLite 中运行失败。
解决方案：

• 使用 PRAGMA 查看版本特性：PRAGMA compile_options;
• 通过 CREATE TABLE IF NOT EXISTS 避免重复建表。

结论：从创建到应用的延伸

通过本文，您已掌握了 SQLite 数据库创建的核心方法，并了解了如何通过命令行或编程接口实现这一过程。从简单的数据存储到复杂的事务管理，SQLite 的灵活性和易用性使其成为开发者的“瑞士军刀”。

建议读者尝试以下实践：

1. 使用 Python 创建一个图书管理系统，包含借阅记录表。
2. 在命令行中通过 EXPLAIN QUERY PLAN 分析查询性能。
3. 探索 SQLite 的虚拟表（Virtual Tables）和全文搜索扩展（FTS）。

记住，数据库设计是一门平衡艺术——既要满足当前需求，也要为未来扩展留有余地。希望本文能成为您探索 SQLite 世界的坚实起点！