跳到主要内容
weapp.dev
返回工具栈
测试版
本地数据
WebWeChat DevToolsSQLite WASM (sql.js)IndexedDBWXWebAssembly

weapp-sqlite

面向小程序工程的本地数据层

通过 weapp-vite 集成 SQLite WASM,提供统一异步查询、事务、迁移与本地持久化。Web 与微信开发者工具已通过自动验收,微信真机仍待验证;当前以测试版展示。

维护者:weapp-sqlite contributors

安装

适合需要在 weapp-vite 工程中评估结构化本地数据、离线存储和数据库迁移的小程序团队。

pnpm add @weapp-sqlite/weapp-vite

先在 Vite 配置中注册 weappSqlite(),再从 @weapp-sqlite/weapp-vite/runtime 导入 openSqlite。Web 与微信开发者工具已通过自动验收,微信真机仍待验证。

工程证据

SQLite 本地数据边界

从一段真实的配置、命令或边界说明开始判断项目是否适合你的工程。

sqlite.ts测试版
  • 统一异步查询、事务与迁移 API
  • Web 使用 IndexedDB,微信使用文件系统持久化
  • Web 与真实微信开发者工具已通过自动验收;微信真机仍待验证

路线状态

接下来会确认什么

  1. 完成 Web 与微信开发者工具自动验收已发布
  2. 完成微信 iOS 与 Android 真机验收规划中

核心能力

  • 统一异步查询、事务与迁移
  • Web IndexedDB 与微信文件系统持久化
  • weapp-vite 插件与运行时集成

常见用法

  1. 01在 weapp-vite 工程中接入本地 SQLite
  2. 02查询结构化数据并管理事务与迁移
  3. 03在 Web 与微信开发者工具中验证持久化行为

支持平台

WebWeChat DevTools
当前版本
v0.3.0
2026年10月3日
周下载
21
GitHub Stars
2

常见问题

目前验证了哪些运行环境?

Web 与真实微信开发者工具已通过自动验收,微信 iOS 与 Android 真机仍待验证。本站按测试版展示;其他小程序平台目前仅提供构建与 unsupported 契约,不代表正式运行支持。

应该安装哪个包?

weapp-vite 工程推荐安装 @weapp-sqlite/weapp-vite,注册 weappSqlite() 插件后从其 runtime 入口导入 openSqlite。具体配置和平台边界以官方文档为准。

未来文档路径

/docs/weapp-sqlite/

聚合文档上线后,此路径将成为 canonical 地址。

实施范围

需先评估适配范围

可将该项目作为技术选型讨论的背景资料。尚未确认针对该工具的实施服务;需先核对官方文档、维护者支持范围与实际仓库,不代表官方合作或支持承诺。

统计偏好

百度统计和 Google Analytics 在正式站点默认启用,用于了解访问与有限交互。你可以随时关闭。