onShareAppMessage中需先判断res.from === "button"，再取res.target.dataset获取按钮data属性；menu来源时res.target为undefined，直接访问会报错。
onShareAppMessage 里怎么拿到按钮点击时的 data 属性
按钮分享和右上角菜单分享走的是同一个生命周期函数 onShareAppMessage，但触发来源不同，参数结构也不同。关键区别在 res.from：值为 "button" 表示是 <button open-type="share"></button> 触发的，此时 res.target.dataset 才有内容；值为 "menu" 则是右上角触发，res.target 为 undefined，不能读 dataset。
常见错误是直接写 res.target.dataset.id，没加判断就报 Cannot read property 'dataset' of undefined。
- 必须先判断
if (res.from === "button")，再取res.target.dataset - 自定义属性名要以
data-开头，比如data-id="123"、data-title="商品A"，Vue 模板中用:data-id="item.id"绑定 - dataset 里的 key 会自动转成小驼峰，
data-share-img→res.target.dataset.shareImg - 如果传的是对象（如
:data-obj="item"），需注意序列化限制：JSON.stringify 后再传，或改用多个扁平字段（data-id、data-title、data-image-url）更稳妥
path 参数怎么拼才不会跳转失败
小程序分享卡片的 path 字段必须是合法页面路径 + query string，任何非法字符或路径错误都会导致点击后白屏或 404。微信不校验，但运行时静默失败。
容易踩的坑包括：中文未编码、空格、特殊符号（如 #、{}）、路径不在 pages.json 的 pages 列表里。
- 必须用
encodeURIComponent编码所有动态值，例如：path: `/pages/product/detail?id=${encodeURIComponent(item.id)}&ref=${encodeURIComponent(userInfo.uid)}` - 路径开头不能带
/？错——必须带，且必须与pages.json中注册的路径完全一致（包括大小写） - 不要拼
hash（如#/detail），小程序不支持；也不要拼完整 URL（如https://xxx.com/...） - query 中的 key 建议全小写、用下划线或中划线分隔，避免驼峰（部分旧版基础库对大小写敏感）
imageUrl 加载不出来怎么办
分享图片显示为空白或默认图标，90% 是 imageUrl 不符合微信硬性要求。它既不是普通网络请求，也不走 uni-app 的资源加载逻辑。
微信强制要求：必须是 HTTPS 协议、可公开访问、服务器响应头允许跨域（CORS）、且域名已配置在小程序后台「downloadFile 合法域名」白名单中。
- 本地路径（如
/static/share.jpg）在onShareAppMessage中无效 —— 小程序分享机制不识别本地资源 - 网络图必须能用浏览器直接打开，且状态码为 200；若返回 302 跳转，微信可能拒绝加载
- 图片尺寸建议 ≥ 500×400px，宽高比 5:4 或 1:1，过小会被压缩失真
- 调试时可用
uni.downloadFile先测试该 URL 是否能成功下载，排除网络或权限问题
为什么 onShareTimeline 无法区分按钮和菜单触发
朋友圈分享（onShareTimeline）和好友分享（onShareAppMessage）机制完全不同：onShareTimeline 只能由右上角菜单触发，<button open-type="share"></button> 对它完全无效，且入参 option 恒为空对象。
这意味着你没法像处理好友分享那样靠 option.from 做动态定制。所有朋友圈卡片内容必须提前确定，无法根据用户点击位置实时生成。
- 朋友圈卡片标题、图片、path 都只能返回静态值或页面级变量（如
ref或computed），不能依赖事件上下文 - 想实现“同一页面不同内容的朋友圈分享”，只能靠业务层规避：比如把不同商品页拆成独立页面，每页配专属
onShareTimeline - 务必检查三重开关：manifest.json 勾选分享、pages.json 设置
"enableShareTimeline": true、微信公众平台后台手动开启“分享到朋友圈”
真正难的不是写几行代码，而是让 path 解析后能精准还原原始上下文，同时保证 imageUrl 在任意网络环境下稳定加载——这两点一旦出错，用户看到的就是一张空白卡片，连 debug 都没提示。
