更新记录

1.0.0（2026-09-03） 下载此版本

初版

平台兼容性

uni-app(3.8.3)

其他

SQLite 通用操作工具 (SL-SqlLite.js)

基于 uni-app plus.sqlite 的 Promise 化 SQLite 操作工具，仅支持 App（5+） 环境。非 App 环境（H5 / 小程序）调用任何方法会自动 reject 并弹窗提示。

快速开始

import db from '@/SL-SqlLite/SL-SqlLite.js'

// 1. 打开数据库
await db.openDatabase('mydb.db', '_doc/')
db.setCurrentDBName('mydb.db')

// 2. 建表
await db.createTable('user', 'id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER')

// 3. 新增
await db.insert('user', { name: '张三', age: 25 })

// 4. 查询
const list = await db.selectAll('user', '*', null, 'id DESC')
const one  = await db.selectOne('user', 'id = 1')
const cnt  = await db.count('user', 'age > 20')

// 5. 修改
await db.update('user', { name: '李四', age: 30 }, 'id = 1')

// 6. 删除
await db.remove('user', 'id = 1')

// 7. 事务
await db.transaction(async () => {
  await db.insert('user', { name: '王五', age: 28 })
  await db.insert('user', { name: '赵六', age: 32 })
})

// 8. 关闭
await db.closeDatabase('mydb.db')

环境检测

if (!db.isApp()) {
  const platform = db.getPlatformName() // 'H5' | '微信小程序' | ...
  uni.showModal({ title: '提示', content: `当前为${platform}，无法使用 SQLite` })
  return
}

• isApp() 返回 true 时为 App 环境，false 为其他平台

• 非环境下调用任何数据库方法会自动弹窗提示并 reject，不会崩溃

API 一览

数据库管理

原始 SQL

注意：plus.sqlite 不支持 ? 参数绑定，所有 SQL 需手动拼接完整值。便捷 CRUD 方法已内部处理。

便捷 CRUD

表结构

事务

await db.transaction(async () => {
  await db.insert('account', { name: 'A', balance: 100 })
  await db.insert('account', { name: 'B', balance: 200 })
  // 若中途出错，自动 ROLLBACK，两条都不会写入
})

值转义说明

plus.sqlite.executeSql 不支持 ? 占位符绑定，工具内部通过 toSqlValue() 手动拼接：

查询结果注意事项

plus.sqlite.selectSql 返回的是 native 代理对象，Vue 模板无法直接读取属性。查询后需浅拷贝为纯 JS 对象：

const rows = await db.selectAll('user')
// 推荐：浅拷贝后赋值给 Vue data
this.list = rows.map(r => ({ id: r.id, name: r.name, age: r.age }))

常见问题

-1402 Same Name Already Open

数据库已打开时重复调用 openDatabase 会报此错误。解决：先检查再打开。

const isOpen = await db.isOpenDatabase('mydb.db')
if (!isOpen) {
  await db.openDatabase('mydb.db')
}

中文乱码

SQLite 原生支持 UTF-8 中文存储，无需特殊处理。若出现乱码通常是 HTML/JS 文件编码问题，确保 .vue / .js 文件以 UTF-8 无 BOM 保存。

非环境调用

非 App 环境下调用任何方法会自动弹窗提示并 reject，不会崩溃：

SQLite 仅支持 App 环境运行，当前为 H5，无法使用数据库功能

完整 API 导出