Назад към всички

mini-program-dev

// 微信小程序开发辅助。提供代码模板、API 示例、常见问题解答。

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namemini-program-dev
description微信小程序开发辅助。提供代码模板、API 示例、常见问题解答。
metadata[object Object]

微信小程序开发辅助

常用代码模板

页面结构

// pages/demo/demo.js
Page({
  data: {
    message: 'Hello',
    list: [],
    loading: false
  },

  onLoad(options) {
    // 页面加载
    this.fetchData();
  },

  onShow() {
    // 页面显示
  },

  onPullDownRefresh() {
    // 下拉刷新
    this.fetchData().then(() => {
      wx.stopPullDownRefresh();
    });
  },

  fetchData() {
    this.setData({ loading: true });
    return new Promise((resolve, reject) => {
      wx.request({
        url: 'https://api.example.com/data',
        success: res => {
          this.setData({ 
            list: res.data,
            loading: false 
          });
          resolve(res);
        },
        fail: reject
      });
    });
  },

  handleTap(e) {
    console.log('tap', e.currentTarget.dataset);
  }
})
<!-- pages/demo/demo.wxml -->
<view class="container">
  <text class="title">{{message}}</text>
  
  <block wx:for="{{list}}" wx:key="id">
    <view class="item" bindtap="handleTap" data-id="{{item.id}}">
      {{item.name}}
    </view>
  </block>

  <loading wx:if="{{loading}}">加载中...</loading>
</view>
/* pages/demo/demo.wxss */
.container {
  padding: 20rpx;
}

.title {
  font-size: 32rpx;
  font-weight: bold;
  display: block;
  margin-bottom: 20rpx;
}

.item {
  padding: 20rpx;
  border-bottom: 1rpx solid #eee;
}

常用 API

// 提示框
wx.showToast({ title: '成功', icon: 'success' });
wx.showModal({ title: '提示', content: '确认?' });

// 跳转页面
wx.navigateTo({ url: '/pages/detail/detail?id=1' });
wx.redirectTo({ url: '/pages/detail/detail' });
wx.switchTab({ url: '/pages/index/index' });

// 存储
wx.setStorageSync('key', 'value');
const value = wx.getStorageSync('key');

// 授权
wx.getUserProfile({
  success: res => {
    console.log(res.userInfo);
  }
});

// 支付
wx.requestPayment({
  timeStamp: '',
  nonceStr: '',
  package: '',
  signType: 'MD5',
  paySign: '',
  success: () => {},
  fail: () => {}
});

组件通信

// 父组件 → 子组件
// parent.wxml
<child-component id="child" data="{{parentData}}" />

// parent.js
this.selectComponent('#child').childMethod();

// 子组件 → 父组件
// child.js
this.triggerEvent('myEvent', { detail: 'data' });

// child.wxml
<view bind:myEvent="handleEvent" />

// parent.wxml
<child-component bind:myEvent="handleEvent" />

TabBar 配置

// app.json
{
  "pages": [
    "pages/index/index",
    "pages/profile/profile"
  ],
  "window": {
    "navigationBarTitleText": "我的小程序"
  },
  "tabBar": {
    "color": "#999",
    "selectedColor": "#1890ff",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath": "/icons/home.png",
        "selectedIconPath": "/icons/home-active.png"
      },
      {
        "pagePath": "pages/profile/profile",
        "text": "我的",
        "iconPath": "/icons/user.png",
        "selectedIconPath": "/icons/user-active.png"
      }
    ]
  }
}

常见问题

1. 页面不刷新

检查是否在 onShow 而非 onLoad 中处理数据刷新。

2. 授权失败

记得在 app.jsonpermission 中声明权限:

{
  "permission": {
    "scope.userLocation": {
      "desc": "用于展示附近内容"
    }
  }
}

3. 安卓真机调试

使用 vConsole 查看日志:

wx.vibrateLong(); // 震动提示

需要具体页面的代码吗?告诉我你的需求 📱