iOS开发 SQLite数据库

封面图 • 2025-11-26 • iOS开发

在iOS开发中，使用 **SQLite** 数据库是一种常见的方式，用于存储和管理本地数据。虽然苹果提供了更高级的持久化框架（如 Core Data），但在某些场景下（比如需要直接操作 SQL、性能要求高或兼容性好），SQLite 仍然是一个非常实用的选择。

---

## 📌 一、SQLite 简介

SQLite 是一个轻量级的嵌入式数据库引擎，不需要单独的服务器进程，所有的数据都存储在一个文件中。它支持标准的 SQL 查询语言，并且适用于移动应用开发。

---

## 🧰 二、在 iOS 中使用 SQLite 的方式

### 1. 使用原生 SQLite C API
- 优点：性能高，灵活性强。
- 缺点：代码复杂，容易出错，需要手动处理内存和错误。

#### 示例：创建数据库并插入数据

```objective-c
// 导入 SQLite 头文件
#include <sqlite3.h>

- (void)createDatabase {
    NSString *docsDir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    NSString *dbPath = [docsDir stringByAppendingPathComponent:@"mydatabase.sqlite"];
    
    sqlite3 *database;
    if (sqlite3_open([dbPath UTF8String], &database) == SQLITE_OK) {
        const char *sql = "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER);";
        char *error;
        if (sqlite3_exec(database, sql, NULL, NULL, &error) != SQLITE_OK) {
            NSLog(@"Error creating table: %s", error);
            sqlite3_free(error);
        } else {
            NSLog(@"Table created successfully.");
        }
        
        // 插入数据
        sql = "INSERT INTO users (name, age) VALUES ('Alice', 25);";
        if (sqlite3_exec(database, sql, NULL, NULL, &error) != SQLITE_OK) {
            NSLog(@"Error inserting data: %s", error);
            sqlite3_free(error);
        } else {
            NSLog(@"Data inserted successfully.");
        }
        
        sqlite3_close(database);
    } else {
        NSLog(@"Failed to open database.");
    }
}
```

> ⚠️ 注意：使用 C API 需要手动处理所有错误和内存。

---

### 2. 使用第三方封装库（推荐）

为了简化 SQLite 操作，可以使用一些封装好的库，例如：

#### ✅ 推荐库：
- **FMDB**（Swift 和 Objective-C 都支持）
- **GRDB.swift**（Swift 原生库）
- **SQLite.swift**（纯 Swift 实现）

---

## 🔧 三、使用 FMDB 进行 SQLite 操作（Swift）

### 1. 安装 FMDB（通过 CocoaPods）

在 `Podfile` 中添加：

```ruby
pod 'FMDB'
```

然后执行：

```bash
pod install
```

### 2. 示例代码（Swift）

```swift
import FMDB

class DatabaseManager {
    static let shared = DatabaseManager()
    private var db: FMDatabase!
    
    private init() {
        let docsDir = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true).first!
        let dbPath = docsDir.appendingPathComponent("mydatabase.sqlite")
        db = FMDatabase(path: dbPath)
        
        if !db.open() {
            print("无法打开数据库")
            return
        }
        
        // 创建表
        let createTableSQL = """
        CREATE TABLE IF NOT EXISTS users (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            name TEXT,
            age INTEGER
        )
        """
        if !db.executeUpdate(createTableSQL, withArgumentsIn: []) {
            print("创建表失败: $db.lastErrorDescription)")
        } else {
            print("表已创建或已存在")
        }
    }
    
    func insertUser(name: String, age: Int) {
        let sql = "INSERT INTO users (name, age) VALUES (?, ?)"
        if !db.executeUpdate(sql, withArgumentsIn: [name, age]) {
            print("插入失败: $db.lastErrorDescription)")
        } else {
            print("用户插入成功")
        }
    }
    
    func queryUsers() {
        let sql = "SELECT * FROM users"
        if let results = db.executeQuery(sql, withArgumentsIn: []) {
            while results.next() {
                let id = results.int(forColumn: "id")
                let name = results.string(forColumn: "name") ?? ""
                let age = results.int(forColumn: "age")
                print("ID: $id), Name: $name), Age: $age)")
            }
        }
    }
}
```

---

## 🧪 四、常用 SQLite 命令（参考）

| 命令 | 功能 |
|------|------|
| `CREATE TABLE` | 创建新表 |
| `INSERT INTO` | 插入数据 |
| `SELECT` | 查询数据 |
| `UPDATE` | 更新数据 |
| `DELETE` | 删除数据 |
| `DROP TABLE` | 删除表 |

---

## 📁 五、数据存储路径

在 iOS 中，建议将数据库文件存储在以下路径中：

```swift
let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
let dbURL = documentsDirectory.appendingPathComponent("mydatabase.sqlite")
```

---

## 📚 六、参考资料

- [SQLite 官方文档](https://www.sqlite.org/docs.html)
- [FMDB GitHub](https://github.com/ccgus/fmdb)
- [GRDB.swift 官网](https://grdb.org/)
- [SQLite.swift 官网](https://github.com/stephencelis/SQLite.swift)

---

如果你有具体的使用场景（比如增删改查、多线程操作、加密等），我可以提供更详细的代码示例或优化建议。欢迎继续提问！