uni-app微信朋友圈分享需三重手动开启权限：manifest.json勾选分享并填appid、pages.json设enableShareTimeline:true、后台功能设置中开启开关；onShareTimeline返回的path须为合法小程序路径（如/pages/home/index）且参数仅支持?key=value格式，imageUrl必须是HTTPS直链、尺寸≥300×300px，不支持thumb、desc等字段，否则卡片空白或跳转404。
uni-app 微信朋友圈分享必须手动开启三重权限，且 onShareTimeline 返回的 path 和 imageUrl 有硬性校验，错一个就显示空白卡片或跳转 404。
pages.json 和 manifest.json 必须显式开启 enableShareTimeline
朋友圈入口不会自动出现，漏掉任意一项配置，右上角菜单里就只剩“转发给朋友”，控制台零报错——这是最常被忽略的静默失败。
- manifest.json 中“Share(分享)”模块必须勾选，“微信分享”项填了正确 appid
- pages.json 对应页面需加
"enableShareTimeline": true，不能只写"enableShareAppMessage": true - 微信公众平台后台 → 小程序设置 → 功能设置 → 手动开启“分享到朋友圈”开关（2026 年仍需人工开通）
onShareTimeline 返回对象字段极其严格
朋友圈卡片不支持 desc、query 字段以外的参数拼接，也不接受 hash 或空格，title 超 48 字符会被截断，imageUrl 加载失败直接降级为默认图标。
-
path只能是合法小程序路径，如/pages/home/index；带参数必须用?key=value形式，中文/空格需encodeURIComponent处理 -
imageUrl必须是 HTTPS 直链，/static/share.jpg或相对路径无效；安卓微信 8.0.33+ 要求尺寸 ≥ 300×300px - 不支持
thumb、desc、success、fail等字段；返回多余字段会导致静默降级
朋友圈无法通过按钮触发，也不能靠 option.from 区分来源
自定义 只能唤起好友/群聊分享，对朋友圈完全无效；onShareTimeline 的入参 option 始终为空对象，无法判断是右上角还是其他入口触发。
- 朋友圈分享只能由右上角菜单触发，业务上想做差异化卡片，得靠服务端动态生成不同
path或imageUrl - 不要在
mounted或onShow里预调用uni.share({ target: 'timeline' })，微信会直接忽略 - 如果分享前要拉取标题或图片，必须用
await确保数据就绪再 return，否则传的是空值或默认值
从朋友圈进入是“单页模式”，不是完整小程序环境
用户点击朋友圈卡片后进入的页面，顶部有固定导航栏、底部有“前往小程序”栏，且无法隐藏；很多 API 如 wx.login 会直接报 login:fail rejected due to no permission。
- 判断是否来自朋友圈，可靠方式是读取
uni.getLaunchOptionsSync().scene === 1154 - 该环境下无法静默登录、不能调用支付、不能读取用户手机号，需提前设计兜底逻辑（如引导点击“前往小程序”）
- 页面底部 TabBar 会被底部操作栏遮挡，UI 必须适配单页模式的固定容器结构
最容易被忽略的是：朋友圈卡片的 path 必须能在小程序内真实打开，且不能依赖 onLaunch 里的全局状态——单页模式下，页面是独立加载的，onLoad 拿不到 store 或 globalData 里的共享数据。
