uni-app无法通过按钮点击直接唤起朋友圈分享，必须配置manifest.json、pages.json和微信公众平台后台三处开关，并在页面export default中顶层定义onShareTimeline函数，返回含title和HTTPS imageUrl的对象。
uni-app 无法通过按钮点击直接唤起朋友圈分享，这是微信平台的硬性限制，不是代码能绕开的。所谓“实现”，本质是让右上角「…」→「分享到朋友圈」入口正常显示，并能正确渲染卡片——这需要三处配置全开、函数位置严格、图片合规，漏一不可。
onShareTimeline 必须写在页面 script 内，且和 onLoad 同级
全局 mixin、App.vue 里注册、或包裹在 methods 里，全部无效。微信只认具体页面 export default 对象顶层定义的 onShareTimeline 函数。
- ✅ 正确：在
pages/index/index.vue的export default中直接写onShareTimeline() { return { title: 'xxx', imageUrl: 'https://...' } } - ❌ 错误：在
mixins/share.js中导出再通过Vue.mixin()注入 - ⚠️ 注意：
<script setup></script>下必须显式调用onShareTimeline(() => { ... })，不能只 import 不执行
manifest.json、pages.json、微信公众平台后台三处开关缺一不可
这三项任意一个没开，右上角菜单里“分享到朋友圈”会静默消失，控制台无报错、开发者工具也不提示，是最常被卡住的地方。
-
manifest.json→ 「App模块配置」→ 「Share(分享)」→ 勾选「微信分享」，并填对mp-weixin.appid -
pages.json→ 对应页面配置项中加"enableShareTimeline": true（不是enableShareAppMessage） - 微信公众平台后台 → 小程序「设置」→「功能设置」→ 手动开启「分享到朋友圈」开关（2026 年仍需人工开通）
onShareTimeline 返回对象字段极简，但约束极严
它不支持 path 带 hash、不接受本地路径、不认 desc 或 success 回调，稍有偏差就 fallback 成纯文字链接或空白卡片。
-
imageUrl必须是 HTTPS 直链，推荐尺寸 ≥ 500×500px（安卓微信 8.0.33+ 会校验， - 标题
title≤ 48 字符，超长会被截断且不换行 -
query是唯一支持传参的字段，如query: 'uid=123'，需确保值已encodeURIComponent - 必须共存
onShareAppMessage：哪怕只返回{ title: '默认' }，否则朋友圈入口不渲染
朋友圈打开的小程序是单页模式，API 能力受限
用户从朋友圈卡片点进来的环境不是完整小程序，而是“单页模式”，顶部有固定导航栏、底部有“前往小程序”按钮，很多逻辑会意外失效。
-
wx.login、wx.authorize等授权类 API 会直接失败，错误为login:fail rejected due to no permission - 无法跳转其他页面，
uni.navigateTo无效 - 不能靠
uni.getEnv()准确识别该环境，更可靠的是检查 URL 中是否含from=timeline参数
最容易被忽略的其实是图片直链可用性——别只看本地开发时能显示，务必用浏览器直接访问 imageUrl 地址，确认 HTTP 状态码是 200、响应头允许跨域、且图片内容可正常加载。微信服务器要能自己拉取成功，才算真正过关。
