当前位置：首页 > news >正文

Vue 集成和使用 SQLite 的完整指东

news 2026/2/9 14:03:50

1. 引言

SQLite 是一种轻量级的关系型数据库管理系统，以其简单易用、无需服务器等特点广泛应用于嵌入式系统、移动应用和小型应用程序中。在 Web 开发中，尤其是前端应用开发中，SQLite 可以作为客户端本地存储的一种选择，为用户提供离线数据存储和访问的能力。

在 Vue.js 项目中使用 SQLite，可以将应用的数据存储在客户端，这对于开发 PWA（渐进式 Web 应用）或需要在离线环境下运行的应用非常有用。本文将介绍如何在 Vue 项目中集成 SQLite，并通过实例讲解其实际应用。

2. 环境准备

在开始之前，我们需要确保开发环境已经配置好，并安装了必要的依赖。

2.1 Node.js 和 Vue CLI 安装

首先，你需要安装 Node.js 和 Vue CLI 以便创建 Vue 项目。你可以通过以下步骤安装这些工具：

下载并安装 Node.js，确保安装了最新的稳定版本。
安装 Vue CLI：

npm install -g @vue/cli

2.2 创建 Vue 项目

使用 Vue CLI 创建一个新的 Vue 项目：

vue create sqlite-vue-app

按照提示选择配置选项，这里选择默认配置即可。

2.3 安装 SQLite 依赖

要在 Vue 项目中使用 SQLite，我们可以借助一些库来简化操作，例如 sql.js 或者 node-sqlite3。

安装 sql.js：

npm install sql.js

sql.js 是 SQLite 的 JavaScript 实现，允许在浏览器中直接操作 SQLite 数据库。

如果你的应用需要运行在 Node.js 环境下（例如 Electron 应用），你可以使用 node-sqlite3：

npm install sqlite3

3. SQLite 数据库操作

3.1 创建 SQLite 数据库

在 Vue 项目中，可以通过 sql.js 在浏览器内存中创建一个 SQLite 数据库：

import initSqlJs from 'sql.js';export default {data() {return {db: null,};},async created() {const SQL = await initSqlJs({ locateFile: filename => `https://sql.js.org/dist/${filename}` });this.db = new SQL.Database();},
};

上述代码中，我们通过 initSqlJs 初始化 SQLite，并在 Vue 组件中创建一个 SQLite 数据库实例。

3.2 执行 SQL 语句

一旦创建了数据库实例，就可以使用 SQL 语句来创建表、插入数据、查询数据等操作。例如，创建一个用户表并插入一些数据：

this.db.run(`CREATE TABLE users (id INTEGER PRIMARY KEY,name TEXT,email TEXT);
`);this.db.run(`INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com');
`);

3.3 查询数据

可以使用 SELECT 语句查询数据，并将结果显示在 Vue 组件中：

const results = this.db.exec("SELECT * FROM users;");
const users = results[0].values;
console.log(users);

4. 在 Vue 组件中展示 SQLite 数据

接下来，我们将学习如何在 Vue 组件中展示从 SQLite 数据库查询到的数据。

4.1 数据绑定和渲染

将查询到的用户数据绑定到 Vue 组件的数据模型中，并在模板中渲染：

data() {return {db: null,users: []};
},
async created() {const SQL = await initSqlJs({ locateFile: filename => `https://sql.js.org/dist/${filename}` });this.db = new SQL.Database();this.db.run(`CREATE TABLE users (id INTEGER PRIMARY KEY,name TEXT,email TEXT);`);this.db.run(`INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com');`);const results = this.db.exec("SELECT * FROM users;");this.users = results[0].values;
}

在模板中使用 v-for 指令渲染用户数据：

<ul><li v-for="user in users" :key="user[0]">{{ user[1] }} - {{ user[2] }}</li>
</ul>

4.2 数据的增删改查

除了展示数据外，实际应用中我们通常还需要支持对数据的增删改查操作。以下是一个完整的示例，展示了如何在 Vue 组件中实现对 SQLite 数据的增删改查。

4.2.1 添加数据

可以通过表单输入用户信息，然后插入到 SQLite 数据库中：

<form @submit.prevent="addUser"><input v-model="newUser.name" placeholder="Name" /><input v-model="newUser.email" placeholder="Email" /><button type="submit">Add User</button>
</form>

在 methods 中实现 addUser 方法：

methods: {addUser() {this.db.run(`INSERT INTO users (name, email) VALUES ('${this.newUser.name}', '${this.newUser.email}');`);this.fetchUsers(); // 重新获取数据},fetchUsers() {const results = this.db.exec("SELECT * FROM users;");this.users = results[0].values;}
}

4.2.2 删除数据

在用户列表中添加删除按钮，并实现删除功能：

<ul><li v-for="user in users" :key="user[0]">{{ user[1] }} - {{ user[2] }}<button @click="deleteUser(user[0])">Delete</button></li>
</ul>

在 methods 中实现 deleteUser 方法：

methods: {deleteUser(id) {this.db.run(`DELETE FROM users WHERE id = ${id};`);this.fetchUsers(); // 重新获取数据}
}

4.2.3 更新数据

更新数据通常需要弹出一个编辑表单，用户可以修改数据并提交更改。下面是实现更新功能的代码示例：

<ul><li v-for="user in users" :key="user[0]">{{ user[1] }} - {{ user[2] }}<button @click="editUser(user)">Edit</button></li>
</ul><div v-if="editingUser"><h3>Edit User</h3><form @submit.prevent="updateUser"><input v-model="editingUser.name" /><input v-model="editingUser.email" /><button type="submit">Update</button></form>
</div>

在 methods 中实现 editUser 和 updateUser 方法：

data() {return {editingUser: null};
},
methods: {editUser(user) {this.editingUser = { ...user };},updateUser() {this.db.run(`UPDATE users SET name = '${this.editingUser.name}', email = '${this.editingUser.email}' WHERE id = ${this.editingUser.id};`);this.editingUser = null;this.fetchUsers(); // 重新获取数据}
}

5. 将 SQLite 数据库持久化

在浏览器环境中，SQLite 数据库默认是存储在内存中的，这意味着刷新页面后数据将丢失。如果希望数据持久化存储，可以将数据库导出为文件，并在需要时加载。

5.1 导出数据库

可以使用 sql.js 提供的 export 方法将数据库导出为二进制文件，并使用 FileSaver 库保存到本地：

npm install file-saver

在 Vue 组件中实现导出功能：

import { saveAs } from 'file-saver';methods: {exportDB() {const data = this.db.export();const blob = new Blob([data], { type: 'application/octet-stream' });saveAs(blob, 'database.sqlite');}
}

5.2 加载数据库

加载持久化的数据库文件可以通过 sql.js 的 Database 方法实现：

async loadDB(file) {const data = await file.arrayBuffer();this.db = new SQL.Database(new Uint8Array(data));this.fetchUsers(); // 加载数据
}

在模板中添加文件输入，用于选择数据库文件：

<input type="file" @change="loadDB($event.target.files[0])" />

6. 使用 SQLite 进行高级操作

在实际应用中，除了基本的增删改查操作，我们可能还需要进行更复杂的数据库操作，如事务处理、索引管理、多表查询等。SQLite 作为一个完整的关系型数据库管理系统，提供了丰富的功能支持。

6.1 事务处理

事务处理用于确保一组数据库操作要么全部成功，要么全部回滚。可以使用 BEGIN TRANSACTION 和 COMMIT 来实现事务处理：

this.db.run("BEGIN TRANSACTION;");
try {this.db.run("INSERT INTO users (name, email) VALUES ('Charlie', 'charlie@example.com');");this.db.run("INSERT INTO orders (user_id, product) VALUES (1, 'Laptop');");this.db.run("COMMIT;");
} catch (e) {this.db.run("ROLLBACK;");console.error("Transaction failed: ", e);
}

6.2 索引管理

为了提高查询性能，可以在常用的查询字段上创建索引：

this.db.run("CREATE INDEX idx_users_name ON users(name);");

6.3 多表查询

在 SQLite 中，可以使用 SQL 的 JOIN 语法进行多表查询。例如，查询用户及其订单信息：

const results = this.db.exec(`SELECT users.name, orders.product FROM users JOIN orders ON users.id = orders.user_id;
`);
const userOrders = results[0].values;
console.log(userOrders);

7. 结论

在 Vue 项目中使用 SQLite 数据库为应用提供了强大的本地数据存储能力，特别适用于离线应用和轻量级数据管理场景。本文介绍了在 Vue 项目中集成 SQLite 的全过程，从环境准备、数据库操作、数据展示，到高级操作的实现。

通过这种方式，我们可以在前端应用中实现复杂的数据库操作，并为用户提供更好的数据存储和管理体验。希望本文能够为你在 Vue 项目中使用 SQLite 提供参考和帮助。