Files
Neo-ZQYY/_DEL/wechat-miniprogram/POWER.md
2026-03-15 10:15:02 +08:00

7.4 KiB
Raw Blame History

name, displayName, description, keywords, author
name displayName description keywords author
wechat-miniprogram 微信小程序官方文档 微信小程序开发官方文档查询工具覆盖框架、组件、API、服务端、自定义组件等全部开发知识。当需要查阅小程序开发细节时按需加载对应领域的 steering 文件获取权威参考。
微信小程序
miniprogram
wxml
wxss
wx.request
小程序组件
小程序API
Page
Component
getApp
小程序生命周期
小程序登录
小程序支付
weixin
wechat
tdesign
t-button
t-cell
t-dialog
t-toast
t-navbar
t-tabs
t-popup
t-input
t-picker
t-tag
t-search
t-empty
t-loading
t-skeleton
t-tab-bar
t-avatar
t-badge
t-image
NeoZQYY

微信小程序官方文档

Overview

本 Power 是微信小程序官方开发文档的结构化知识库,覆盖框架核心概念、视图层、逻辑层、自定义组件、内置组件、前端 API、服务端 API 等全部开发领域。

当 AI 需要回答小程序相关问题时,应根据问题领域加载对应的 steering 文件,获取官方文档的权威内容,而非依赖可能过时的训练数据。

官方文档入口:https://developers.weixin.qq.com/miniprogram/dev/framework/

文档结构与 Steering 文件索引

以下 steering 文件按领域组织,按需加载:

framework-core.md — 框架核心

  • 小程序框架概述MINA 架构:逻辑层 + 视图层)
  • 小程序配置app.json / page.json / sitemap.json
  • 目录结构与文件类型(.wxml / .wxss / .js / .json
  • 场景值、兼容性、基础库版本

app-service.md — 逻辑层App Service

  • App() 注册程序、生命周期
  • Page() 注册页面、页面生命周期onLoad/onShow/onReady/onHide/onUnload
  • 页面路由navigateTo/redirectTo/switchTab/reLaunch/navigateBack
  • 模块化require/module.exports、文件作用域
  • API 调用方式(回调/Promise
  • 页面间通信、EventChannel

view-layer.md — 视图层WXML / WXSS / WXS

  • WXML 语法:数据绑定、列表渲染(wx:for)、条件渲染(wx:if)、模板(template)、引用(import/include)
  • WXSS 样式rpx 单位、样式导入(@import)、选择器支持范围、内联样式
  • WXSWeiXin Script语法、模块、与 WXML 配合使用
  • 事件系统:冒泡/非冒泡事件、bind/catch/mut-bind、事件对象、dataset

custom-component.md — 自定义组件

  • 创建自定义组件json/wxml/wxss/js 四文件)
  • Component() 构造器properties / data / methods / lifetimes / pageLifetimes / observers
  • 组件模板和样式slot、样式隔离 styleIsolation
  • 组件间通信properties 传值、triggerEvent 事件、selectComponent
  • behaviors代码复用类似 mixins
  • 数据监听器observers
  • 纯数据字段pureDataPattern
  • 组件间关系relations
  • 抽象节点componentGenerics
  • 用 Component 构造器构造页面

builtin-components.md — 内置组件

  • 视图容器view / scroll-view / swiper / movable-view / cover-view
  • 基础内容text / rich-text / progress / icon
  • 表单组件button / input / textarea / picker / slider / switch / checkbox / radio / form
  • 导航navigator
  • 媒体image / video / camera / live-player / live-pusher
  • 地图map
  • 画布canvas
  • 开放能力open-data / web-view / ad
  • 无障碍访问

frontend-api.md — 前端 API

  • 基础wx.canIUse / wx.env / 系统信息
  • 路由wx.navigateTo / wx.redirectTo / wx.switchTab / wx.reLaunch / wx.navigateBack
  • 界面wx.showToast / wx.showModal / wx.showLoading / wx.showActionSheet / 导航栏 / TabBar / 下拉刷新
  • 网络wx.request / wx.uploadFile / wx.downloadFile / WebSocket / TCP/UDP
  • 数据缓存wx.setStorage / wx.getStorage / wx.removeStorage
  • 媒体:图片(wx.chooseImage/wx.previewImage) / 录音 / 音频 / 视频 / 相机
  • 位置wx.getLocation / wx.openLocation / wx.chooseLocation
  • 文件wx.saveFile / FileSystemManager
  • 开放接口:登录(wx.login) / 用户信息 / 支付(wx.requestPayment) / 授权 / 设置 / 收货地址 / 发票 / 生物认证 / 微信运动 / 订阅消息
  • 设备:蓝牙 / NFC / Wi-Fi / 电话 / 加速计 / 罗盘 / 陀螺仪 / 剪贴板 / 屏幕亮度 / 振动
  • Worker / 第三方平台 / WXML 节点查询(SelectorQuery / IntersectionObserver)
  • 画布 Canvas API

server-api.md — 服务端 API

  • 登录code2Sessioncode 换 session_key + openid
  • access_token 获取与管理
  • 用户信息解密(手机号、用户信息)
  • 消息推送(订阅消息、客服消息、模板消息)
  • 小程序码与二维码生成
  • 内容安全(文本/图片审核)
  • 数据分析
  • 物流助手
  • OCR / 直播 / 安全风控

login-auth.md — 登录与鉴权(重点)

  • wx.login() 获取 code 的完整流程
  • 服务端 code2Session 换取 openid / session_key / unionid
  • 自定义登录态设计token 方案)
  • wx.checkSession() 检查 session_key 有效性
  • 手机号快速验证getPhoneNumber
  • 用户信息获取getUserProfile 已废弃 → 头像昵称填写能力)
  • 授权流程wx.authorize / wx.getSetting / wx.openSetting
  • 常见登录架构与安全注意事项

best-practices.md — 开发最佳实践与常见坑

  • setData 性能优化(减少数据量、避免频繁调用)
  • 分包加载subpackages / 独立分包 / 分包预下载)
  • 图片优化与懒加载
  • 页面栈管理(最多 10 层)
  • 小程序与 H5 差异(无 DOM/BOM、不支持 window/document
  • TypeScript 支持
  • npm 支持与构建
  • 自定义 tabBar
  • 骨架屏
  • 常见审核被拒原因与规避

tdesign.md — TDesign 小程序组件库

  • TDesign 安装与配置npm 构建、TS 配置、基础库要求)
  • 完整组件列表60+ 组件,按基础/导航/输入/数据展示/反馈分类)
  • 常用组件用法示例Button / Input / Cell / Dialog / Toast / Popup / Tabs / Navbar / TabBar / Search / Empty / Loading / Skeleton
  • 样式覆盖 4 种方式style 属性 / 解除隔离 / 外部样式类 / CSS 变量)
  • 自定义主题(全局 Design Token / CSS Variables
  • 深色模式适配

使用方式

当遇到小程序相关问题时:

  1. 根据问题领域,使用 readSteering 加载对应的 steering 文件
  2. 如果不确定属于哪个领域,先加载 framework-core.md 了解整体架构
  3. 登录/鉴权问题优先加载 login-auth.md
  4. 组件用法问题加载 builtin-components.mdcustom-component.md
  5. API 调用问题加载 frontend-api.mdserver-api.md
  6. TDesign 组件用法/样式定制加载 tdesign.md

在线查询

如果 steering 文件中的信息不够详细,可以直接访问官方文档页面获取最新内容:

使用 webFetch 工具抓取对应页面即可获取最新文档内容。