official-account组件不显示是因微信平台限制：需基础库≥2.3.0、公众号与小程序主体一致且后台绑定、用户必须从扫码（1011/1047）、聊天顶部（1089）或小程序返回（1038）等特定场景进入；开发调试需手动设编译场景为1011。
uni-app 中无法“直接关注”公众号，official-account 组件只提供引导入口，不触发自动关注；它是否显示、能否响应事件，完全取决于微信平台的运行时限制和配置状态。
为什么 official-account 组件不显示？
不是代码写错了，而是微信根本不让它渲染。这个组件有硬性前提：
- 小程序基础库必须 ≥
2.3.0（开发者工具里编译模式选错版本就白搭） - 公众号必须在小程序后台「设置 → 接口设置 → 公众号关注组件」中完成绑定，且主体需与小程序一致
- 用户必须从特定场景进入小程序：扫码（场景值
1011或1047）、聊天顶部“最近使用”（1089）、或从其他小程序返回（1038） - 直接从微信首页下拉、搜索、历史记录进入，组件不会出现
开发调试时，必须在 HBuilderX 或微信开发者工具中手动设置编译场景为 1011 才能看到效果。
怎么正确使用 official-account 组件？
组件本身极简，但属性和事件绑定容易漏掉：
- 必须用
@load和@error监听加载状态，不能只靠样式判断是否就绪 - 组件不支持自定义内容，但可包裹在
<view>内通过定位/遮罩做视觉强化 - 每个页面只能有一个
<official-account>，重复写多个也只渲染第一个 - 不要给它设
display: none或动态v-if控制显隐——它内部依赖微信原生渲染逻辑，隐藏后可能无法重新激活
示例写法：
<view style="position: relative; height: 200rpx;"> <official-account @load="onLoad" @error="onError" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></official-account> </view>
用户没关注，怎么知道？
official-account 不提供“是否已关注”的回调，它只负责展示。要判断用户是否关注公众号，必须走服务端方案：
- 通过公众号网页授权（
snsapi_base）获取code，换openid，再调用微信接口https://api.weixin.qq.com/cgi-bin/user/info查询关注状态 - 前提是公众号和小程序已在微信开放平台绑定，才能拿到统一的
unionid，否则无法跨平台关联用户身份 - 前端跳转
<web-view>是唯一可行路径，但需提前在公众号后台配置业务域名，且web-view页面必须是 HTTPS
注意：getUserProfile 或 uni.login 拿到的是小程序的 openid，跟公众号无关，别混淆。
替代方案比 official-account 更可靠
当场景不可控（比如用户从搜索进入），official-account 形同虚设。更实际的做法是：
- 在页面固定位置放一张高清公众号二维码图，用
<image>加scanCode提示文案，不依赖任何平台能力 - 跳转公众号文章页（用
web-view加公众号推广链接），文章内嵌公众号卡片+关注按钮，转化路径更自然 - 如果需要强引导，可在用户完成关键操作（如提交表单）后弹出浮层，图文并茂说明“关注后可接收通知”，而非强求立即关注
真正难的从来不是组件怎么写，而是微信对用户行为路径的层层限制——你得先接受这个前提，再设计兜底方案。
