必须在页面级生命周期中注册onAddToFavorites监听器,开启「启用收藏功能」配置,使用微信基础库2.24.0+模板,确保navigationStyle为default,并通过动态提取、数据绑定或静态配置设置收藏卡片内容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在码上飞AI生成的小程序中实现“点击右上角收藏按钮→将当前页面加入用户收藏夹”的功能,必须在页面级生命周期中主动注册收藏事件监听器,否则小程序右上角的原生收藏按钮不会触发任何逻辑,用户点击后无响应。
确认小程序基础配置支持收藏
打开码上飞AI项目控制台,在「发布设置」→「小程序平台」中勾选【启用收藏功能】。该选项默认关闭,未开启时即使后续写入代码,微信客户端也不会渲染收藏胶囊按钮。
检查当前小程序模板是否为微信基础库 2.24.0+ 版本。低于此版本的模板不支持 onAddToFavorites 生命周期,系统会自动降级为仅显示按钮但无法回调——【必须使用最新模板生成,旧项目需重新导出或刷新沙箱环境】。
在目标页面中注册收藏事件
进入码上飞AI编辑器,定位到你希望被收藏的具体页面(如商品详情页、文章页),点击右侧「页面逻辑」标签页。
在「页面生命周期」区域找到「添加收藏回调」开关并开启。系统将自动生成标准 onAddToFavorites 函数骨架,并预留标题、图片、路径三项返回字段。
这一步操作起来很简单,直接开启开关即可;但注意:若页面未配置 navigationStyle: custom,收藏按钮会与原生导航栏重叠,导致点击失效——【务必同步检查该页面的 JSON 配置中 navigationStyle 值为 default 或不设】。
自定义收藏卡片内容
方法一:使用默认动态生成
保持「收藏标题」字段为空,系统将自动提取当前页面 data 中的 title 字段或 WXML 根节点文本作为标题;图片取首张 image 组件 src 或默认占位图。
方法二:手动绑定数据字段
在「收藏标题」输入框中填写 {{pageTitle}},在「收藏图片」填写 {{coverImg}},确保对应 data 中已定义这两个变量。例如在页面 onLoad 中执行 this.setData({ pageTitle: '《量子物理入门》笔记', coverImg: '/imgs/qm.jpg' })。
方法三:完全静态配置
直接输入固定文字和绝对路径,如标题填“我的学习收藏”,图片填“/static/fav-icon.png”。这种方式无需依赖 data 变量,适合单页静态内容场景。
验证收藏行为是否生效
第一步:点击编辑器右上角「实时预览」→ 用手机微信扫码进入小程序。
第二步:打开已配置收藏回调的页面 → 点击右上角三个点 → 出现「收藏」按钮 → 点击它。
第三步:观察手机屏幕顶部是否弹出“已收藏”提示;若无反应,立即返回编辑器检查:① 页面是否在 app.json 的 pages 列表中;② onAddToFavorites 函数是否被意外删除;③ 当前账号是否为体验版管理员(非管理员账号收藏后不显示成功提示)。


















