家里东西总找不到,我用 Taro + Vue3 写了个物品管理小程序(附 8 个踩坑)
本文记录我给自己的小程序「记忆之王」做"空间记忆"(家庭物品管理)功能的过程:为什么这么设计、几个实现细节,以及踩过的 8 个坑。技术栈是 Taro 4 + Vue 3 + TypeScript,后端 Express + MySQL。
起因:家里的东西,放下就忘
这些场景你可能也遇到过:
- 家里有人发烧,翻遍抽屉找退烧药;找到一瓶糖浆,却想不起是什么时候开封的
- 备用钥匙、门禁卡收得太好,要用时谁都想不起放哪了
- 充电宝、转接头买了好几个,因为每次都找不到前一个
- 囤的纸巾、洗衣液快用完了,去超市时又忘了买
问题都一样:东西放下时没记,要用时找不到。 至于过期、用完这些状态,就更没人记得。
常见办法的问题
备忘录 / 表格:记录成本高。放个东西还要打开表格找到对应行,很难坚持。
专门的 App:要下载、注册,家里人很难为了找个钥匙专门装一个 App。
拍照存相册:拍的时候很方便,找的时候要在几千张照片里翻。
所以我给这个功能定了三条要求:
- 记录要快:拍张照、写个位置就完事,其他都是选填
- 找起来要快:搜名称、位置、甚至症状都能搜到
- 家里人能一起用:小程序,微信点开就能用,不用装 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 次。物品和家庭相关页面也都关闭了转发。
体验比点卡片多一步,但能过审,也更可控。
小结
这个功能最大的体会是:记录成本决定了工具能不能用下去。
所以大部分设计都在给记录"减负":
- 必填项只有两个
- 最近用过的位置一点就填
- 条码扫一次就记住
- 新建物品可以"保存并继续",整理药箱时一口气录完,分类和位置都保留着
至于余量、有效期、用药信息,都是选填,想记再记。
如果你家里也总找不到东西,可以试试:微信扫码或搜索「记忆之王」,进入"空间记忆"即可使用,免费,微信登录就能用。
欢迎在评论区聊聊你家最常找不到的是什么,或者你希望它还能做什么。