plus.sqlite.selectSql 必须传入完整 SQL 字符串，不支持参数化查询；需手动转义单引号、字符串加单引号、数值校验、NULL 用 IS NULL、分页用 LIMIT/OFFSET。
plus.sqlite.selectSql 传参必须是完整 SQL 字符串
UniApp 的 plus.sqlite.selectSql 不支持参数化查询（即没有 placeholder 占位符机制），SQL 语句和条件必须拼接成完整字符串后传入。直接拼接用户输入极易引发 SQL 注入，尤其是姓名、ID 等字段含单引号或通配符时。
常见错误现象：查询返回空数组，控制台无报错，但 fail 回调里实际有 "near 'xxx': syntax error"；或者查出意外的多条记录。
- 正确做法是手动转义关键字符：对单引号
'替换为两个单引号''，再拼入 SQL - 模糊查询用
LIKE时，需自行包裹%，例如：name LIKE '%'+escapedName+'%' - 数值型条件可直接拼接，但建议先用
Number()转换并校验 isNaN - 时间戳、布尔值等类型不要加引号，否则 SQLite 会当作字符串比较
WHERE 条件中字符串值必须用单引号包裹
SQLite 对字符串字面量要求严格：必须用单引号 ' 包裹，双引号 " 在部分平台会被忽略或报错。这是最常被忽略的语法细节，尤其从 Web 开发转过来的人容易写成双引号。
使用场景：按用户名查记录、按状态筛选订单、按日期范围拉取日志。
- ✅ 正确：
SELECT * FROM users WHERE name = '张三' AND status = 1 - ❌ 错误：
SELECT * FROM users WHERE name = "张三"（双引号可能失效） - ❌ 错误：
SELECT * FROM users WHERE name = 张三（未加引号 → 解析为列名） - ⚠️ 注意：
NULL比较必须用IS NULL，不能写= NULL
分页查询要靠 LIMIT 和 OFFSET，不能依赖 page/pageSize 封装
UniApp 的 SQLite API 没有内置分页参数，selectSql 只接受原始 SQL。如果封装了 page: 2, pageSize: 10 的接口，必须手动计算 OFFSET 值：即 (page - 1) * pageSize。
性能影响：大表 OFFSET 越大越慢，因为 SQLite 需跳过前面所有行。10 万行数据查第 1000 页（OFFSET 9990）可能卡顿明显。
- 推荐写法：
SELECT * FROM messages ORDER BY time DESC LIMIT 10 OFFSET 9990 - 更优替代：用游标分页（
WHERE id ），避免 OFFSET 性能衰减 - 不要在
WHERE中对字段用函数（如strftime('%Y', created_at)），会阻止索引使用
查询结果字段名大小写敏感，且不自动转驼峰
selectSql 返回的结果数组中，每个对象的 key 完全匹配 SQL 中 SELECT 的字段名（含大小写）。比如建表时写的是 user_name，就不能用 data.userName 访问。
容易踩的坑：前端习惯用驼峰，后端建表用下划线，结果取值为 undefined 却找不到原因。
- 查表结构确认真实字段名：
PRAGMA table_info(users) - 可在 SQL 中用别名统一风格：
SELECT user_name AS userName FROM users - 批量处理时建议用
Object.keys(result[0])打印一次，眼见为实
