家里东西总找不到,我用 Taro + Vue3 写了个物品管理小程序(附 8 个踩坑)

0 阅读9分钟

家里东西总找不到,我用 Taro + Vue3 写了个物品管理小程序(附 8 个踩坑)

本文记录我给自己的小程序「记忆之王」做"空间记忆"(家庭物品管理)功能的过程:为什么这么设计、几个实现细节,以及踩过的 8 个坑。技术栈是 Taro 4 + Vue 3 + TypeScript,后端 Express + MySQL。


起因:家里的东西,放下就忘

这些场景你可能也遇到过:

  • 家里有人发烧,翻遍抽屉找退烧药;找到一瓶糖浆,却想不起是什么时候开封的
  • 备用钥匙、门禁卡收得太好,要用时谁都想不起放哪了
  • 充电宝、转接头买了好几个,因为每次都找不到前一个
  • 囤的纸巾、洗衣液快用完了,去超市时又忘了买

问题都一样:东西放下时没记,要用时找不到。 至于过期、用完这些状态,就更没人记得。


常见办法的问题

备忘录 / 表格:记录成本高。放个东西还要打开表格找到对应行,很难坚持。

专门的 App:要下载、注册,家里人很难为了找个钥匙专门装一个 App。

拍照存相册:拍的时候很方便,找的时候要在几千张照片里翻。

所以我给这个功能定了三条要求:

  1. 记录要快:拍张照、写个位置就完事,其他都是选填
  2. 找起来要快:搜名称、位置、甚至症状都能搜到
  3. 家里人能一起用:小程序,微信点开就能用,不用装 App

做出来的样子

在这里插入图片描述

整个功能就三个页面:列表、详情、编辑。

记录:点"记录物品"直接拍照,照片里把物品和它所在的位置一起拍进去。必填项只有名称和存放位置,位置输入框下面列出"最近用过"的位置,点一下就填好。

查找:列表左侧是分类(药品、钥匙卡片、电子数码、工具电器、衣物床品、贵重物品、食品囤货、其他),顶部是按位置分组的筛选,回答"这个抽屉里有什么"。搜索会同时匹配名称、位置、描述和药品用途,搜"发烧"能直接找到退烧药。

维护:东西挪了地方,在详情页点位置卡片就能改;余量(充足 / 剩一半 / 快用完 / 已用完)点一下就保存;标记遗失后找到了,会问一句"在哪找到的?",顺手更新位置。

在这里插入图片描述

首页提醒:首页会列出最需要处理的 3 件东西,已过期、快过期、余量不足的都算。


几个设计上的取舍

1. 位置是唯一的核心答案

用户打开详情页只想知道一件事:它在哪。所以详情页的位置单独做成一张大卡片,用功能色、大字号,其他信息都往后排。

"换位置"是物品最常见的变化,频率比改名称高得多。最开始要进编辑页改整张表单,后来改成在位置卡片上点一下,弹出底部输入框直接改,列表页长按也能改。

2. 药品的"实际可用日期"

药盒上印的是包装有效期,但滴眼液、糖浆这类药开封后很快失效。只看包装有效期,会误以为开头那瓶糖浆还能用。

所以药品多记两个字段:开封日期、开封后可用天数(提供 7 天、28 天、3 个月、6 个月几个常用选项)。到期提醒按两者中较早的那个算:

/**
 * 药品实际可用日期:包装有效期 与 开封日期 + 开封后可用天数 中较早的一个。
 * 开封当天算第 1 天,例如 10-25 开封、28 天可用,最后可用日为 11-21
 */
export const getEffectiveExpiry = (
  expireDate?: string | null,
  openedDate?: string | null,
  openShelfDays?: number | null,
) => {
  const opened = openedDate ? dayjs(openedDate) : null;
  const openedExpireDate = opened?.isValid() && openShelfDays && openShelfDays > 0
    ? opened.add(openShelfDays - 1, "day").format("YYYY-MM-DD")
    : null;
  if (!openedExpireDate) {
    return { date: expireDate || null, openedExpireDate: null, limitedByOpening: false };
  }
  // 'YYYY-MM-DD' 字符串按字典序比较即按日期先后比较
  const limitedByOpening = !expireDate || openedExpireDate < expireDate;
  return {
    date: limitedByOpening ? openedExpireDate : expireDate,
    openedExpireDate,
    limitedByOpening,
  };
};

详情页会说明这个日期是怎么算出来的("开封于 10-25 · 开封后 28 天"),避免用户以为包装有效期填错了。

30 天内到期的标橙色,已过期的标红色,列表里有单独的"即将到期"筛选,按剩余天数排序,最急的排最前。

3. 扫码录入:不接第三方商品库,自己记

扫条形码自动填名称,常见做法是接一个第三方商品数据库。但这样要依赖外部服务,数据是否覆盖家里那些药和日用品也说不准。

我换了个思路:自建映射。第一次扫某个条码时查不到,用户手动填好名称保存,系统就记下"条码 → 名称、分类、常用属性"。下次自己或家人再扫同一个条码,就自动填好。

家里常买的东西就那么几十种,用一段时间以后,大部分都能扫出来。

4. 家庭共享的权限边界

家里人一起用才有意义,但权限得想清楚:

  • 新物品默认家庭可见,贵重物品默认仅自己
  • 家人可以查看和编辑共享物品(比如帮你更新余量),但只有添加人能删除和修改可见范围
  • 每人只能加入一个家庭,最多 10 人
  • 加入家庭时,已有物品不会自动共享

踩过的坑

坑 1:Taro Vue 里布尔属性只写属性名,等于 false

列表的分类栏怎么都滑不动,代码看起来没问题:

<!-- ❌ 编译后 scroll-x 的值是空字符串,等同 false -->
<scroll-view scroll-x>

<!-- ✅ 必须显式绑定 -->
<scroll-view :scroll-x="true">

在 Taro 的 Vue 模板里,原生组件的布尔属性只写属性名,会被编译成 "",小程序当成 false 处理。项目里同样的写法一共有 5 处,lazy-load、catch-move 也一样。

坑 2:showModal 传了 undefined,点了没反应

详情页的"标记遗失"按钮点了没任何反应,"删除"却正常。两者都走同一个确认函数:

// ❌ 不传颜色时 confirmColor 是 undefined
const confirmAction = async (title: string, content: string, confirmColor?: string) => {
  const { confirm } = await Taro.showModal({ title, content, confirmColor });
  return confirm;
};

差别在于删除传了 confirmColor,标记遗失没传。微信小程序的 API 会校验参数类型,undefined 不是字符串,调用会失败、弹窗出不来;而这个 Promise 的异常又没人处理,界面上就是"没反应"。改成有值才传:

// ✅
await Taro.showModal({ title, content, ...(confirmColor ? { confirmColor } : {}) });

坑 3:scroll-view 的 scroll-top 只在值变化时生效

切换分类后想让列表回到顶部,绑定 :scroll-top="0" 只有第一次有效。原因是用户滚动不会更新绑定值,值一直是 0,没有变化就不会触发滚动。

解法是在 0 和 0.01 之间来回切换:

const toggleZero = (value: number) => (value === 0 ? 0.01 : 0);

const listScrollTop = ref(0);
watch([activeFilter, locationFilter], () => {
  listScrollTop.value = toggleZero(listScrollTop.value);
});

顶部位置栏切换分类时滚回最左边,scroll-left 用的是同一个办法。

坑 4:loading 和 toast 是同一个提示层

保存失败时,request 封装里弹了错误提示,紧接着 hideLoading(),结果错误提示也被一起关掉了。微信里 loading 和 toast 共用同一个提示层。

所以统一写了个工具函数,先关 loading,再弹错误:

export const hideLoadingWithError = (error: unknown, fallback: string) => {
  Taro.hideLoading();
  Taro.showToast({ title: getMessage(error, fallback), icon: "none" });
};

成功提示同理:先 hideLoading(),再 showToast()。

坑 5:MySQL 的 DATE 字段,到前端少了一天

有效期是纯日期,比如 2027-03-01。如果直接把 DATE 列返回给前端,可能显示成 2027-02-28。

原因是 mysql2 默认把 DATE 转成 JS 的 Date 对象(本地时区零点),JSON 序列化时转成 UTC,东八区会前移 8 小时,跨到前一天。查询时直接输出字符串就没这个问题:

DATE_FORMAT(p.expire_date, '%Y-%m-%d') AS expireDate

坑 6:药盒上有两种码

扫药盒经常识别出一串 20 位数字,每盒都不一样,根本没法用来识别是哪种药。那是药品追溯码,每盒唯一。要扫的是商品条形码,国内商品通常是 69 开头的 13 位。

所以扫码后先判断一下,给出明确提示:

// 商品条码(EAN-8 / UPC-A / EAN-13 / GTIN-14)
const BARCODE_PATTERN = /^\d{8,14}$/;
// 药品追溯码每盒不同,无法识别是哪种药
const TRACE_CODE_PATTERN = /^\d{20}$/;

if (TRACE_CODE_PATTERN.test(code)) {
  Taro.showToast({ title: "这是药品追溯码,请扫描商品条形码(通常 69 开头)", icon: "none" });
  return;
}

坑 7:返回拦截不拦 iOS 手势侧滑

编辑页有未保存的修改时,想在用户返回前问一句。微信提供了 wx.enableAlertBeforeUnload,但按官方文档,弹窗条件只有官方导航栏返回、全屏模式下的自绘返回键和安卓 back 键,手势滑动返回明确不拦截。

所以只能做到"尽量提醒":只在有修改时开启,保存成功后先关掉再返回,避免保存完还被问一句"确定要离开吗":

watch(isDirty, (dirty) => {
  if (dirty) Taro.enableAlertBeforeUnload({ message: "修改还没有保存,确定要离开吗?" });
  else Taro.disableAlertBeforeUnload();
}, { immediate: true });

"有没有修改"用表单快照比对:数据加载完记录一份基准快照,之后和当前表单的 JSON 对比。

坑 8:个人主体小程序,分享功能被驳回

最初的家庭邀请是"转发小程序卡片给家人,点开即加入"。提审被驳回,审核认为涉及"社交-笔记"类服务,个人主体的小程序不能提供。

最后改成 6 位数字邀请码:家人在小程序里输入邀请码加入。邀请码 7 天内有效,可以多人使用;为了防止被暴力尝试,每个账号每小时最多输错 10 次。物品和家庭相关页面也都关闭了转发。

体验比点卡片多一步,但能过审,也更可控。


小结

这个功能最大的体会是:记录成本决定了工具能不能用下去。

所以大部分设计都在给记录"减负":

  • 必填项只有两个
  • 最近用过的位置一点就填
  • 条码扫一次就记住
  • 新建物品可以"保存并继续",整理药箱时一口气录完,分类和位置都保留着

至于余量、有效期、用药信息,都是选填,想记再记。


如果你家里也总找不到东西,可以试试:微信扫码或搜索「记忆之王」,进入"空间记忆"即可使用,免费,微信登录就能用。

记忆之王宣传图.png

欢迎在评论区聊聊你家最常找不到的是什么,或者你希望它还能做什么。