onShareTimeline必须页面级定义且三重权限全开启：manifest勾选分享、pages.json设enableShareTimeline:true、后台手动开开关；返回对象字段严格，仅支持imageUrl和基础path，不支持option.from区分来源，全局混入无效。
onShareTimeline 函数必须在页面级定义，且需手动开启权限
微信小程序的“分享到朋友圈”不是默认开启的功能，onShareTimeline 不像 onShareAppMessage 那样只要写了就能触发——它需要三重确认：项目配置、页面配置、平台后台开关都得对上。
- manifest.json 中“Share(分享)”模块必须勾选，“微信分享”项填写了正确
appid - pages.json 中对应页面必须显式声明
"enableShareTimeline": true，否则右上角菜单里压根不显示“分享到朋友圈”选项 - 微信公众平台后台 → 小程序设置 → 功能设置 → 必须手动开启“分享到朋友圈”开关（2026年仍需人工开启，不是自动开通）
漏掉任意一项，用户点右上角只会看到“转发给朋友”，朋友圈入口消失，且控制台无任何报错提示——这是最常被忽略的静默失败。
分享卡片字段和 path 的写法有硬性限制
onShareTimeline 返回的对象字段比 onShareAppMessage 更严格：不支持 imageUrl 以外的图片字段（比如不能用 thumb），path 也不能带 hash 或 query 参数以外的内容，否则朋友圈卡片会降级为纯文字链接。
-
title最多 48 字符，超长会被截断，且不换行 -
imageUrl必须是 HTTPS 网络地址，本地路径（如/static/share.jpg）或相对路径一律无效 -
path只能是合法的小程序页面路径，例如/pages/home/index；若需传参，只能用?key=value形式，不能含空格、中文、特殊符号（建议encodeURIComponent处理） - 朋友圈卡片不支持自定义
desc或摘要字段，标题就是全部文案
常见错误现象：卡片只显示小程序名称 + 默认图标，点开后跳转白屏或 404——大概率是 path 写错，或 imageUrl 加载失败（可用浏览器直接访问该 URL 验证）。
区分按钮分享和右上角分享，靠 option.from 没用
很多人想在 onShareTimeline 里判断是用户点了右上角还是页面内按钮，但微信目前**不支持**通过 option.from 区分朋友圈分享来源。这个参数只在 onShareAppMessage 中有效，onShareTimeline 的入参 option 始终为空对象。
- 朋友圈分享只能由右上角菜单触发，无法通过
调起 - 如果你在页面里加了自定义分享按钮，它只能触发
onShareAppMessage（好友/群聊），对朋友圈无效 - 想实现“一页双分享策略”，得靠业务逻辑分离：比如在商品页，右上角朋友圈卡片强调品牌调性（固定标题+主图），而按钮分享则带用户 ID 和追踪参数给好友
试图在 onShareTimeline 里写 if (option.from === 'button') 是徒劳的，代码不会报错，但条件永远不成立。
全局混入无法覆盖 onShareTimeline，页面级优先级最高
用 Vue mixin 全局注入 onShareTimeline 听起来很省事，但实际无效。微信小程序底层机制决定了：只有当前页面组件实例上定义的 onShareTimeline 才会被读取，全局混入的同名函数会被完全忽略。
- mixins 里的
onShareTimeline不会自动合并或 fallback，它只是被丢弃 - 如果你有几十个页面要支持朋友圈分享，必须每个页面单独写一遍，或用构建时模板生成（如 vite 插件注入）
- 更稳妥的做法是封装一个可复用的配置函数，比如
getTimelineShareConfig()，在各页面的onShareTimeline里调用它，再根据this.$route或data动态拼字段
真正容易被忽略的复杂点是：朋友圈分享不支持动态域名、不支持运行时修改 imageUrl 缓存策略、且卡片预览图在微信客户端缓存极强——改了图 URL 也得清缓存才能生效，这点连开发者工具都模拟不了。
