微信小程序官方示例（miniprogram-demo）是微信官方提供的全套小程序示例源码，覆盖了小程序框架、组件、API、云开发以及最新的 Agent 点单场景演示。官方欢迎开发者扫描示例码直接体验，也可下载源码用微信开发者工具运行，是学习小程序能力、快速上手官方规范的最佳参考工程。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/wechat-miniprogram/miniprogram-demo |
| 官方文档 | https://developers.weixin.qq.com/miniprogram/dev/framework/ |
| 开源协议 | MIT |
| 主要语言 | JavaScript / Shell（约 95.5%） |
| Star 数 | 约 7.3k |
| 维护方 | 微信开放团队 |
该示例随官方能力持续更新，最新已加入「Agent Demo」章节，演示 WeStoreCafe 小微点单场景：搜索、选规格、下单、地址，以及小微 handoff 进业务页的完整流程。
二、官方图片
官方示例小程序码（微信扫一扫即可体验）：
官方示例运行截图：
三、环境要求
- 微信开发者工具：从官方下载页 https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html 安装 Stable 版。
- 微信客户端版本：6.7.2 及以上（用于真机预览/扫码体验）。
- 本机已安装 Node.js（用于执行
npm run init初始化依赖）。 - 若要体验云开发页面，需在微信开发者工具中开通云开发环境。
- 一个可用的小程序 AppID（测试号也可在工具内选择）。
四、完整运行步骤
1. 下载源码
git clone https://github.com/wechat-miniprogram/miniprogram-demo.git
cd miniprogram-demo
也可以直接在 GitHub 仓库页面下载 ZIP 压缩包解压。
2. 安装 npm 依赖
项目根目录执行：
npm run init
这会安装示例所需的 npm 包。
3. 用微信开发者工具导入
打开微信开发者工具，选择「导入项目」，目录选择刚下载的 miniprogram-demo 根目录，填入你自己的小程序 AppID（测试号可选择「测试号」）。
4. 构建 npm
由于小程序原生不直接支持 node_modules，导入后需要在开发者工具菜单中点击：
工具 → 构建 npm
等待构建完成，示例里依赖 npm 的组件才能正常显示。
5. 编译预览
点击工具栏「编译」，模拟器即可运行示例。真机预览点击「预览」，用微信扫码在手机上体验。
6. 云开发页面（可选）
示例中 miniprogram/page/cloud/ 目录是云开发示例，使用前需在开发者工具里开通云开发环境并按官方说明配置，详见仓库内 miniprogram/page/cloud/README.md。
五、使用方法
浏览框架与组件示例
导入后可以逐页查看官方提供的组件、API 示例，包括视图容器、基础组件、表单组件、导航、媒体、位置、设备能力等。源码位于 miniprogram/pages/ 目录，可直接参考其写法。
Agent Demo 章节
最新版本新增了 WeStoreCafe 点单相关示例，路径如下：
| 路径 | 说明 |
|---|---|
miniprogram/skills/drink-skill |
WeStoreCafe 点单：搜索/选规格/下单/地址，小微 handoff 进业务页 |
miniprogram/packageWeStoreCoffee |
点单分包：首页/选规格/结算 + 目录数据 |
miniprogram/skills/agent-auth-skill |
授权卡片 + 订阅消息/蓝牙授权/微信运动/收货地址 |
需要注意：协议名称与详情页由原子接口 wx.requestAgentPrivacyAuthorization({ privacyAgreements }) 传入，不再在 app.json 中静态声明。
参与贡献
如需给官方示例提 PR，在 miniprogram 目录下执行依赖安装与 lint：
npm install
npm run lint
确保代码通过 lint 后再提交。
六、常见问题 FAQ
1. 导入后组件样式不对、报找不到模块？ 没有执行「工具 → 构建 npm」。小程序原生不解析 node_modules，必须在开发者工具里手动构建一次 npm，依赖才会被打进项目。
2. 提示需要微信客户端 6.7.2 以上？ 示例用到了较高版本的基础库能力，请把微信升级到 6.7.2 及以上，并在开发者工具详情里把基础库调到最新版。
3. 云开发页面打不开？
该页面需要先在微信开发者工具左上角「云开发」里开通环境，并按 miniprogram/page/cloud/README.md 配置后才能运行。
4. 没有 AppID 能跑吗？ 可以。导入项目时 AppID 一栏选择「测试号」即可在模拟器体验，部分需要真实 AppID 的能力（如云开发、支付）除外。
5. npm run init 失败怎么办？
确认本机已安装 Node.js 并能联网；也可跳过 npm，直接在开发者工具里「构建 npm」，工具会按 project.config.json 的设置处理。
6. 如何扫码体验官方示例？ 用微信扫一扫本文第二部分的官方示例小程序码，即可在手机上直接体验，无需下载代码。
七、跳转链接
- GitHub 仓库：https://github.com/wechat-miniprogram/miniprogram-demo
- 微信开发者工具下载：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
- 小程序框架文档：https://developers.weixin.qq.com/miniprogram/dev/framework/