鹏展博

外观

better-sqlite3

约 396 字

NodeJS

概述

better-sqlite3 官方文档

better-sqlite3 是 Node.js 中一个高性能、同步操作的 SQLite3 数据库驱动库， 以其卓越的执行效率和简洁的 API 设计成为轻量级应用本地存储的首选

针对 Node.js 中原生 sqlite3 库的异步回调复杂性及性能瓶颈，better-sqlite3 通过 C++ 扩展直接调用 SQLite3 API，规避了 JavaScript 异步模型带来的上下文切换开销，实现了同步API下的更高并发性能。

优势

  • 性能：基准测试显示，其查询速度可达原生 sqlite3 的 11–24 倍（如单行查询快 11.7 倍，事务写入快 15.6 倍）
  • 同步：同步 API 避免回调地狱，更适合 Koa 等中间件模型，提升代码可读性

安装

npm
npm install better-sqlite3
pnpm
pnpm add better-sqlite3
yarn
yarn add better-sqlite3

使用

import db from 'better-sqlite3'

// 建表
db.exec(`CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)`)
// 插入数据
const insert = db.prepare('INSERT INTO users (name) VALUES (?)')
insert.run('Bob')
// 查询
const row = db.prepare('SELECT * FROM users WHERE id = ?').get(1)
console.log(row.name) // 输出: Bob

预编译语句

const stmt = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)')
stmt.run('Alice', '[email protected]') // 复用编译结果，防 SQL 注入

事务

const trans = db.transaction((users) => {
  for (const user of users) {
    db.prepare('INSERT ...').run(user)
  }
})
trans(users) // 自动提交或回滚

适用场景

  • 轻量级应用（Electron 桌面应用、IoT 设备）
  • 高读低写业务（如配置管理、日志存储）
  • 需加密的本地数据（通过扩展 better-sqlite3-multiple-ciphers 支持 AES 等算法）