微信小程序入门

介绍

特点:

  • 轻量化、即用性

  • 加载速度快于HTML5

  • 无需适配

  • 微信生态整合

  • 云端即时更新,无需审核发布新版本

  • rem、flex布局

2017-至今


小程序语言:

  • wxml:描述页面结构

  • json:设置文件、数据存储和网络请求

  • javascript:业务处理

  • wxss:页面样式

注册

微信公众平台

一个邮箱只能申请一个小程序

ScreenShot_2026-11-12_114736_099

下载

下载 - 微信开放文档 / 小程序-开发-工具

输入注册的APPID

ScreenShot_2026-11-12_115559_218

项目搭建

  • 字体常用为22、17、15、14、12pt

  • 字体颜色:

    色值名称 底色 使用场景
    BW_0_Alpha_0.9 黑 一级内容、评论内容 / 弹窗文字按钮
    BW_0_Alpha_0.5 黑 辅助内容
    Black_Opacity_30 黑 说明内容
    Black_Opacity_15 黑 仅用于虚线和超短的分割
    Black_Opacity_10 黑 分割线

组件库:WeUI

目录结构

ScreenShot_2026-11-12_135447_625

// app.json
{
   // 有多少页面则pages数组有多少项,第一项是首页
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  // 指定小程序状态栏
  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "Weixin",
    "navigationBarBackgroundColor": "#ffffff"
  },
  // 指定全局样式版本,一般用v2
  "style": "v2",
  "componentFramework": "glass-easel",
  "sitemapLocation": "sitemap.json",
  "lazyCodeLoading": "requiredComponents"
}

小程序pages中的配置项可以覆盖app.json中的配置项

创建页面

在app.json中的pages数组中写入新的页面即可生成新的页面文件夹:

ScreenShot_2026-11-12_141146_711

在pages文件夹中创建新的文件夹,并点击右键新建page,也可以生成新的页面:

微信图片_20261112141209_700_1

编译页面

方式一:把需要显示的页面放在app.json文件的pages数组的第一项

方式二:在编译中修改启动页,优先级高于方式一

ScreenShot_2026-11-12_141533_720

修改页面

获取全局值

如果需要全局修改数据,则在app.js中修改globalData

globalData: {
    userInfo: null,
    name:"yuanyu"
  }
var app = getApp();
Page({
  onLoad(options) {
    console.log(app.globalData.name)
  }
})

方法调用

function sayHello(param){
  console.log("hello" + param);
}

module.exports = {
  sayHello
}
// pages/list/index.js
var app = getApp();
var common = require("../../utils/common")
Page({
  onLoad(options) {
    console.log(app.globalData.name)
    common.sayHello(app.globalData.name)
  }
})

获取本页面的值

Page({
  data: {
    sum: 10
  },
  onLoad(options) {
    console.log(this.data.sum)
  }
})

引入全局样式文件

/* 先在app.wxss全局样式引入 */
@import'./common.wxss';

之后在组件中使用这个类即可

常用组件

组件名称 说明
view 视图容器
scroll-view 可滚动视图容器
swiper 滑块视图容器
icon 图标
text 文字
form 表单
input 输入框
navigator 导航
video 视频
tabBar 导航栏
<view>
  <image src="/assets/img/whale.png" mode="aspectFill" class="img_box"></image>
  <text class="txt_box">个人信息介绍</text>
  <text class="txt_box">我的兴趣爱好:看书</text>
  <text class="txt_box">我的年龄:保密</text>
</view>
.img_box{
  display: block;
  width: 100%;
}

.txt_box{
  display: block;
  color: blue;
  font-size: 17pt;
  margin-top: 30px;
  text-align: center;
}

ScreenShot_2026-11-12_143549_588

swiper

滑块视图容器的默认宽度是100%,高度是150px

swiper-item默认宽度和高度都是100%

swiper - 微信开放文档 / 小程序-开发-组件 / 视图容器

<swiper class="swiper-container" autoplay="true" interval="{{interval}}" indicator-dots="true"  indicator-active-color="#7370CA" previous-margin="70rpx" next-margin="70rpx" circular="true" 	indicator-alignment="{{offset}}">
  <swiper-item wx:for="{{arr}}" wx:key="{{item.id}}" class="item-box">
    <image src="{{item.url}}" mode="widthFix"/>
    <text>{{item.title}}</text>
  </swiper-item>
</swiper>
.swiper-container{
  height: 360rpx;
}

.item-box{
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 10rpx;
}
Page({
  data: {
    arr:[
      {url:'/assets/img/whale1.png', title:'小鲸鱼1', id:1},
      {url:'/assets/img/whale2.png', title:'小鲸鱼2', id:2},
      {url:'/assets/img/whale3.png', title:'小鲸鱼3', id:3}
    ],
    interval: 3000,
    offset:[0,50]
  }
})

ScreenShot_2026-11-13_103221_208

页面布局

名称 特点 缺点
table-cell 适用于简单的居中需求 不能实现复杂的布局〔例如:多行多列的嵌套〕,某些老版本的浏览器中,不被完全支持
Translate 通过移动位置实现居中效果 移动端表现良好,但可能需要额外的计算来设置正确的移位值
绝对定位 通过将 top、left、right 和 bottom 设置位置 需要手动计算负边距,这在动态内容或不同屏幕尺寸上可能不太方便
Flex 轻松实现水平和垂直居中 适用于各种屏幕尺寸和设备,具有很好的兼容性

rpx单位

以iPhone6为基准

rpx是小程序独有的解决响应式的单位

路由导航

navigator组件

属性 类型 默认值 必填 说明 最低版本
target string self 否 在哪个目标上发生跳转,默认当前小程序 2.0.7
url string 否 当前小程序内的跳转链接 1.0.0
open-type string navigate、redirect、switchTab、reLaunch、navigateBack、exit 否 跳转方式 1.0.0
delta number 1 否 当 open-type 为 'navigateBack' 时有效,表示回退的层数 1.0.0
version string release 否 当 target="miniProgram" 且 open-type="navigate" 时有效,要打开的小程序版本 2.0.7
hover-class string navigator-hover 否 指定点击时的样式类,当 hover-class="none" 时,没有点击态效果 1.0.0

语法

渲染引擎Skyline

以前的引起Webview都是基于一个线程处理

skyline新创建了一条渲染线程来计算图层布局、绘制、整合渲染任务等,并在AppService中划出一个独立上下文来运行之前的Webview承担的JS逻辑、DOM树构建等

ScreenShot_2026-11-12_154705_850

优点:

  • 不容易阻塞,减少卡顿

  • 无需为每个页面新建JS引擎(webview)

  • 允许页面间共享资源,减少运行时内存

  • 无需通过JSBridge进行数据交换

生命周期

  • 应用的生命周期:

    • launch:初始化

    • show:显示

    • hide:隐藏,切换到后台执行

  • 页面的生命周期:

    • onLoad:页面初始化,用于默认数据初始化、埋点操作
    • onShow:页面进入前台,用于页面刷新数据
    • onReady:初次渲染
    • onHide:页面隐藏,tab切换页面会隐藏
    • onUnload:页面卸载,重定向页面会销毁
  • 组件的生命周期:lifetimes中

    • created:组件实例被创建执行
    • attached:组件实例进入页面节点树执行
    • detached:组件实例从页面节点树移除

数据绑定

PageObject是注册小程序中的一个页面,可以指定页面初始数据、生命周期回调、事件处理函数

data属性的数据类型可以是:字符串、数字、布尔、对象、数组等

在同文件夹的js中定义的数值可以在WXML中使用{{}}直接引用

数据渲染

初始渲染中得到的data和当前节点树会保留下来用于重渲染

每次重渲染时,data和setData数据套用在WXML片段上得到新节点树

把新节树和当前节点树比对,更新节点

把setData数据合并到data中,并用新节点树替换旧节点树,用于下一次渲染

因此,不能直接使用this.data修改值,而要使用this.setData()修改

Page({
  data: {
    sum: 10,
    arr:[1,2,3]
  },
  onLoad(options) {
    this.setData({
      sum: 500,
      arr:[5,6,7]
    })

    console.log(this.data.arr)
  }
})

条件渲染

会销毁或重新渲染

<view>
  <view wx:if="{{length < 0}}">数组长度不正确</view>
  <view wx:elif="{{length > 8}}">超出数组长度了</view>
  <view wx:else>数组正常显示</view>
</view>

可以把条件写在block容器中

 <block wx:if="{{condition}}">
    <image src="/assets/img/whale.png" mode="aspectFill" class="img_box">
    </image>
  </block>

或者使用hidden属性显示或隐藏组件,并没有消耗元素(始终被渲染)

当hidden=true时,display=none

 <block hidden="{{condition}}">
    <image src="/assets/img/whale.png" mode="aspectFill" class="img_box">
    </image>
  </block>

列表渲染

item是每一项,index是索引值

<view class="container">
  <view wx:for="{{arr}}" class="item-box" wx:key="{{index}}">
      <image src="{{item.url}}" mode="widthFix" class="pic-box"/>
      <view>{{item.title}}</view>
      <view>{{item.description}}</view>
  </view>
</view>
.container{
  display: flex;
  flex-wrap: wrap;
  padding: 20rpx;
  flex-direction: row;
  gap: 20rpx;
}

.item-box{
  margin-top: 10rpx;
  width: calc(50% - 10rpx);
  display: flex;
  flex-direction: column;
  text-align: center;
  gap: 10rpx;
}

.pic-box{
  width: 100%;
}

ScreenShot_2026-11-12_175901_108

事件机制

事件将视图层传递到逻辑层

  • 冒泡事件:

    • tap
    • longpress
    • touchstart
    • touchmove
  • 非冒泡事件:

    • input
    • change
    • scroll
    • submit

    事件绑定:

    事件函数可传入event对象

    target是触发事件组件的属性

    currentTarget是当前组件的属性

    • bind

      <view class="outer" bind:tap="outerFn">
        <text>这是外层</text>
        <view class="inner" bind:tap="innerFn">这是内层</view>
      </view>
      
        innerFn(){
          console.log("内部事件函数")
        },
      
        outerFn(){
          console.log("外部事件函数")
        },
      
    • catch:可阻止冒泡

自定义属性

使用data-前缀开头定义自定义属性

通过dataset获取值

jumpToDetail(event){
	console.log(event.currentTarget.dataset)
}

数据传参

  • 通过url参数传递数据,跳转页面wx.navigateTo通过Onload的options参数获取页面跳转时的参数

    jumpToDetail(event){
        let id = event.currentTarget.dataset.id;
        let name = event.currentTarget.dataset.name;
        wx.navigateTo({
          url:`/pages/detail/index?id=${id}&name=${name}`
        })
      }
    
    Page({
      data: {
        id:'',
        name:''
      },
      onLoad(options) {
        this.setData({
          id:options.id,
          name:options.name
        })
      }
    })
    
    <view>
      <text>我是{{id}}号,我叫{{name}}</text>
    </view>
    
  • 在app.js中的globalData中定义全局参数,通过getApp()获取app数据

    // pages/detail/index.js
    var app = getApp();
    Page({
      data: {
        id:'',
        name:'',
        message:''
      },
      onLoad(options) {
        this.setData({
          id:options.id,
          name:options.name
        })
        console.log(app.globalData.message)
      }
      onShow() {
        console.log(app.globalData.message + "1111")
      }
    })
    
  • 通过getCurrentPages()获取页面栈对象,给上一个页面传递参数

      goBack(){
        this.getPages();
        wx.navigateBack(-1);
      },
      getPages(){
        const pages = getCurrentPages(); // 获取所有页面对象
        const prevPage = pages[pages.length - 2];
        prevPage.setData({
          message: app.globalData.message
        })
      },
    

在Onshow中setData修改状态(组件已加载完毕)

网络请求

  • wx.request:发起网络请求

  • wx.uploadFile:上传文件请求

  • wx.downloadFile:下载文件请求

wx.request({
    url:'http://xxx',
    method:'GET',
    data:{
        key1:'value1',
        key2:'value2'
    },
    header:{
        'content-type':'application/json'
    },
    success(res){
        // 请求成功的回调
    },
    fail(err){
        // 请求失败的回调
    }
})
特征 GET 请求 POST 请求
请求方法 GET POST
数据传输方式 通过 URL 传输 通过请求体传输
数据可见性 可见 不可见
数据大小限制 有 无
缓存 可缓存 不可缓存
收藏和分享 可以 不可以
数据安全性 较低 较高
用途 获取数据 提交数据

接口的URL必须经过配置:

  • 域名只支持https

  • 域名必须经过ICP备案

  • 域名不能使用IP地址或localhost

  • 可以配置端口号,但是只能向指定端口号的URL发起请求

由于基于微信客户端开发,因此不存在跨域问题

如果成功收到服务器返回,无论HTTP状态码是多少都会进入success回调

loading效果

  • 使用wx.showNavigationBarLoading()增加loading效果

    使用wx.hideNavigationBarLoading()去掉loading效果

  • wx.showLoading()

    wx.hideLoading()

  • wx.showToast()

    wx.showToast({
        title:'加载中',
        duration: 5000,
        icon: 'loading'
    })
    
  • wx.showModal()

    wx.showModal({
        title:'数据请求',
        content:'请求成功',
        // 按钮逻辑
        complete: res => {
            if(res.cancel){
                
            }
            if(res.confirm){
                
            }
        }
    })
    

下拉刷新、上拉触底

  • 下拉刷新:

    • 全局开启:在app.json中的window设置"enablePullDownTRefresh":true

    • 局部开启:在对应页面的page.json中设置"enablePullDownTRefresh":true

    下拉刷新有默认时间,如果想自定义可使用定时器:

    页面中可以使用onPullDownRefresh监听

    onPullDownRefresh: function(){
        setTimeout(()=>{
            wx.stopPullDownRefresh()
        },1000)
    }
    
  • 上拉触底:触发加载

    • 全局开启:在app.json中的window设置onReachBottomDistance值(距离底部多少距离的时候去加载,默认是50)

    • 局部开启:在对应页面的page.json中设置onReachBottomDistance值

    页面中可以使用onReachBottom监听

分享与收藏

定义onShareAppMessage()右上角才会显示转发按钮

return的对象包含:

  • title

  • path

  • imageUrl


定义onShareTimeline()监听右上角分享到朋友圈按钮的行为

return的对象包含:

  • title

  • query

  • imageUrl


定义onAddToFavorites()监听右上角收藏按钮的行为

return的对象包含:

  • title

  • query

  • imageUrl

本地存储

  • 读取缓存:

    • 同步:wx.getStorageSync

    • 异步:wx.getStorage 只有异步才支持加密存储

    wx.getStorage({
      key: 'key1',
      success: function(res) {
        console.log('异步获取数据成功:', res.data);
      },
      fail: function(res) {
        console.log('异步获取数据失败');
      }
    });
    
    const value = wx.getStorageSync('key2');
    console.log('同步获取数据成功:', value);
    
  • 写入缓存:

    • 同步:wx.setStorageSync

    • 异步:wx.setStorage

    // 页面加载时存储数据
    onLoad: function () {
      // 存储数据到本地缓存中
      wx.setStorage({
        key: 'dataFromLocal',
        data: 'Hello, World!',
        success() {
          console.log('数据存储成功');
        },
        fail() {
          console.log('数据存储失败');
        },
      });
    },
    
    // 页面加载时存储数据
    onLoad: function () {
      // 存储数据到本地缓存中
      wx.setStorageSync('dataFromLocal', 'Hello, World!');
    }
    
  • 删除缓存:每个小程序的缓存空间是10MB

    • 同步:wx.removeStorageSync

    • 异步:wx.removeStorage

    // 异步删除本地缓存中的数据
    wx.removeStorage({
      key: 'dataFromLocal',
      success() {
        console.log('删除成功');
      },
      fail() {
        console.log('删除失败');
      },
    });
    
    // 同步删除本地缓存中的数据
    wx.removeStorageSync('dataFromLocal');
    
  • 删除所有缓存:

    • 同步:wx.clearStorageSync

    • 异步:wx.clearStorage

地理位置

  1. 开通授权

    ScreenShot_2026-11-13_164728_211

  2. 配置app.json中permission选项和requiredPrivateInfos配置项

    "permission": {
      "scope.userFuzzyLocation": {
        "desc": "你的地理位置信息将用于xxxx功能"
      }
    },
    "requiredPrivateInfos": [
      "getFuzzyLocation"
    ],
    
  3. 引用方法:wx.stopLocationUpdate - 微信开放文档 / 小程序-开发-API / 位置

用户信息

调用wx.login获取登录凭证,有效期5min

获取微信头像和昵称:

<view>
  <image src="{{imageUrl}}" mode=""/>
  <button open-type="chooseAvatar" bindchooseavatar="getImage">获取微信头像</button>
  <input type="nickname" placeholder="请输入微信昵称"/>
</view>
getImage(e){
    this.setData({
      imageUrl:e.detail.avatarUrl
    })
  }

只有企业级的小程序才能使用ex.openCustomerServiceChat打开微信客服

文件

文件读取:

ex.openDocument({
    filePath:'',
    fileType:'',
    success(){
        
    },
    fail(){
        
    }
})

文件上传/下载需要申请域名:小程序

uploadImage: function (filePath) {
  // 上传图片
  wx.uploadFile({
    url: 'https://example.com/upload',
    filePath: filePath,
    name: 'file',
    success: (res) => {
      console.log('上传图片成功', res);
    },
    fail() {
      console.log('上传图片失败');
    },
  });
},


downloadImage: function () {
  // 下载图片
  wx.downloadFile({
    url: 'https://example.com/path/to/your/image',
    success: (res) => {
      console.log('下载图片成功', res.tempFilePath);
      // 创建图片
      this.createImage(res.tempFilePath);
    },
    fail() {
      console.log('下载图片失败');
    },
  });
}
// 创建图片
createImage: function (filePath) {
  // 创建图片
  const image = wx.createImage();
  image.src = filePath;
  image.onload = () => {
    console.log('图片加载成功');
    // 将图片添加到页面上
    this.setData({
      imageSrc: filePath,
    });
  };
  image.onerror = () => {
    console.log('图片加载失败');
  };
},

支付

只有商户才能支付

具备:appid、mchid

  • 在账户中心-API安全中设置APIV3密钥

  • 下载API证书:下载证书工具-安装证书-生成证书串-生成证书

  • 在微信公众平台-微信支付进行开通

wx.requestPayment({
  provider: 'wxpay',
  appId: data.appId, // 此参数可不用
  nonceStr: data.nonceStr,
  package: data.package,
  signType: data.signType,
  paySign: data.paySign,
  timeStamp: data.timeStamp,
  success: (res) => {
    wx.navigateTo({
      url: '/pages/index/index'
    })
  },
  fail: function (err) {
    wx.showToast({
      title:"支付失败",
      mask: false,//是否显示透明蒙层,防止触摸穿透,默认:false
    })
  }
})

AI

小程序基础库>2.30.2,微信版本号>8.0.32

  1. 获取推理环境

    wx.getInferenceEnvInfo({
        success: res => {
            const {version, supportedModelFormats} = res;
        }
        fail: err => {
        console.error(err)
    }
    })
    
  2. 创建推理接口

    const modelFile = 'xxx.onnx';
    const session = wx.createInferenceSession(modelFile);
    const inputTensor = {
        type:'float32',
        shape:[1,3,224,224],
        data: new Float32Array(1*3*224*224)
    };
    session.run([inputTensor]).then(output => console.log("推理结果", output))
    .catch( err => console.log("推理失败", err));
    

组件

  1. 在根目录中创建components文件夹放置自定义组件文件夹

  2. 在components创建文件夹后右键点击“新建component”快速创建文件

    此时创建出来的js文件是Component而不是Page

  3. 引入自定义组件:在页面的json文件中通过usingComponents引入

    "usingComponents": {
        "myHeader":'/components/myheader/index'
      }
    

    也可以在app.json中全局引入


页面与组件的区别:

  • 组件的json需要声明component:true

  • 组件的js文件定义在Component()中,页面在Page()中

  • 组件的事件处理函数在methods节点内

  • 组件的生命周期定义在lifetimes节点内

自定义组件样式穿透

自定义组件的样式只对当前组件有效,不影响组件之外的

全局样式对组件无效,组件具有自我隔离

只有class组件会隔离样式,id选择器、属性选择器、标签选择器不受样式隔离的影响

如果需要修改样式隔离效果,可以在json文件中设置"styleIsolation":"apply-shared"(外部可以影响组件内部,但是组件内部不会影响外部,需要注意此时依旧是组件内的样式优先级更高,需使用!important来提高页面样式的优先级)

如果设置值是shared则页面和组件互相影响

默认是isolated(启用样式隔离)

自定义组件属性

创建的自定义组件的js文件中包含:

  • properties:外部传入的值,可以赋值给内部

    • type

    • value

  • data:组件内部定义的数据

  • methods

  • observers:数据监听

    observers:{
        'collapsed': function(){
            console.log('变化了',this.data.collapsed)
        } ,
         'obj.**': function(){
             console.log('深层监听',this.data.obj)
         },
         '**': function(){
             console.log('监听所有数据',this.data.obj)
         }
    }
    

如果使用的是多插槽,则需要开启:options:{multipleSlots:true},并且插槽需要进行命名

生命周期

生命周期 参数 描述 最低版本
created 无 在组件实例刚刚被创建时执行,不能调用setData,通常给组件的this添加自定义属性 1.6.3
attached 无 在组件实例进入页面节点树时执行,this.data已初始化完毕 1.6.3
ready 无 在组件在视图层布局完成后执行 1.6.3
moved 无 在组件实例被移动到节点树另一个位置时执行 1.6.3
detached 无 在组件实例被从页面节点树移除时执行 1.6.3
error Object Error 每当组件方法抛出错误时执行 2.4.1

组件在页面内的生命周期:定义在pageLifetime节点中

生命周期函数 参数 描述
show 无 组件所在页面被展示时执行
hide 无 组件所在页面被隐藏时执行
resize Object Size 组件所在页面尺寸变化时执行

组件通信

通过behaviors共享特性来通信

每个behavior可以包含属性、数据、生命周期函数、方法

使用步骤:

  1. 创建Behavior文件

    module.exports = Behavior({
      //属性节点
      properties: {
    
      },
      //私有数据节点
      data: {
        userName: '张三',
        userAge: 10,
      },
      //其它节点
      methods: {
        updataInfo() {
          this.setData({
            userName: '王五',
            userAge: 20
          })
          wx.showToast({
            title: '修改成功',
            mask: true
          })
        },
      },
    })
    
  2. 在自定义组件的js文件中引入Behavior

    const my_behavior = require("../../behavior/my-behavior.js");
    
    Page({
      data: {
        showImg: ''
      },
      behaviors: [
        my_behavior
      ],
    })
    
  3. 在自定义组件的xml在使用Behavior数据和方法

    <view style="text-align: center;">
        my_behaviors中的数据: 姓名: {{userName}} 年龄: {{userAge}}
    </view>
    
  4. 在父组件的json文件中引入自定义组件

  5. 在父组件中引入并使用自定义组件


父组件给子组件传递数据

<!-- 父组件 -->
<child-component myProp="{{myData}}" />

Page({
  data:{
    myData:'123'
}
})
<!-- 子组件 -->
<view>子组件接收的数据:{{myProp}}</view>

Component({
  properties:{
    myProp:{
      type:String,
      value:""
}
}
})

子组件给父组件传递数据:通过事件

// 子组件
<button bind:tap="btnHandle">click</button>

methods: {
    btnHandle: ()=>{
      this.triggerEvent('myEvent', {
        data:'我是子组件'
      })
    }
  }
<!-- 父组件 -->
<view>
  <myHeader myProp="{{myData}}" bind:myEvent="handleMyEvent"></myHeader>
</view>

handleMyEvent(event){
    const dataFromChild = event.detail.data;
    console.log(dataFromChild)
  }

其他组件之间的通信:

  • 通过缓存来通信:

    // A组件
    Component({
      methods: {
        setData: function() {
          wx.setStorageSync('key', 'Hello, World!')
        }
      }
    })
    
    // B组件
    Component({
      data: { value: "" },
      methods: {
        getData: function() {
          const value = wx.getStorageSync('key');
          this.setData({ value })
        }
      }
    })
    
  • 通过globalData来通信:

    // 组件 A.js
    Component({
      methods: {
        setData: function() {
          const app = getApp();
          app.globalData.globalVar = 'Hello, World!'
        }
      }
    })
    
    // 组件 B.js
    Component({
      data: { value: "" },
      methods: {
        getData: function() {
          const app = getApp();
          const value = app.globalData.globalVar;
          this.setData({ value })
        }
      }
    })
    
    // App.js
    App({
      globalData: {
        globalVar: ''
      }
    })
    

性能优化

  • 启动时优化:更快打开并看到内容

    • 冷启动:首次打开

    • 热启动:已经打开过,在一定时间内再次打开

    打开率/到达率PV = 首次渲染完成次数 / 小程序启动次数

    启动性能优化方案:

    • 代码包体积优化

    • 代码注入优化

    • 首屏渲染优化

  • 运行时优化:使用更流畅

    优化方案:

    • 合理使用setData

    • 渲染性能优化

    • 页面切换优化

    • 资源加载优化

    • 内存优化

分包

把一个完整项目划分为不同子包,在构建时打包成不同的分包,用户在使用的时候按需加载

  • 主包:放置默认启动页面/TabBar页面、所有分包都有用到的公共资源/JS脚本

  • 分包:只包含和当前分包有关的页面和私有资源

好处:优化小程序首次启动的下载时间;在多人开发时可以很好解耦写作


加载规则:

  • 小程序启动时,默认会下载主包并启动主包内页面(tabbar页面需要放在主包处)

  • 整改小程序的所有分包大小(主包+所有分包)不能>16MB,单个分包/主包大小不能>2MB

  • 分包必须包含这个模块的所有资源


配置:在app.json的subpackages中声明

{
  "pages": [
    "pages/index/index",
    "pages/list/index",
    "pages/my/index"
  ],
  "tabBar": {
    "selectedColor": "#1296db",
    "position": "bottom",
    "list":[
     {
      "pagePath":"pages/index/index",
      "text":"首页",
      "iconPath": "/assets/tabbar/index.png",
      "selectedIconPath": "/assets/tabbar/act_index.png"
     },
     {
      "pagePath":"pages/list/index",
      "text":"列表",
      "iconPath": "/assets/tabbar/list.png",
      "selectedIconPath": "/assets/tabbar/act_list.png"
     },
     {
      "pagePath":"pages/my/index",
      "text":"我的",
      "iconPath": "/assets/tabbar/my.png",
      "selectedIconPath": "/assets/tabbar/act_my.png"
     }
    ]
  },
  "usingComponents": {

  },
  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "Weixin",
    "navigationBarBackgroundColor": "#ffffff",
    "enablePullDownRefresh": true
  },
  "style": "v2",
  "componentFramework": "glass-easel",
  "sitemapLocation": "sitemap.json",
  "lazyCodeLoading": "requiredComponents",
  "subPackages": [
    {
      "root":"packA",
      "pages": [
        "pages/detail/index"
      ]
    },{
      "root":"packB",
      "pages": [
        "pages/testOne/index",
        "pages/testTwo/index"
      ]
    }
  ]
}

ScreenShot_2026-11-16_163940_988


独立分包:可以直接启动的分包

普通分包必须依赖于主包才能运行,独立分包可以在不下载的情况下独立运行

独立分包和主包及普通分包之间是相互隔绝的,不能互相引用彼此的资源

如:电商小程序中的促销活动是临时的,需要频繁更新,因此可以将促销模块设计为一个独立分包,这样可以在促销活动期间只需加载该分包,在活动结束时卸载

只需在subpackages中设置independent:true即可


分包预下载:在进入小程序某个页面时,由框架自动预下载可能需要的分包,从而提升进入后续页面的速度

"preloadRule": {
  "pages/index": {
    "network": "all",
    "packages": ["important"]
  },
  "sub1/index": {
    "packages": ["hello", "sub3"]
  },
  "sub3/index": {
    "packages": ["path/to"]
  },
  "indep/index": {
    "packages": ["__APP__"] // 主包
  }
}

同一个分包中的页面享有共同的预下载大小限额是2MB

如小程序里有一个分包,包含了页面 A 和页面 B。

  • 页面 A 为了性能,设置了一些预下载任务,总共下载了 0.5MB 的数据

  • 页面 B 的预下载额度就只剩下 1.5MB

代码注入优化

  • 按需注入:在启动时仅注入当前访问页面所需的自定义组件和页面代码,未访问的页面和未使用的自定义组件不会被加载和初始化

    在app.json中设置"lazyCodeLoading": "requiredComponents"

    插件包和扩展库目前不支持按需注入,如需实现可以将插件置于一个分包,通过分包异步化的形式异步引入

    没使用的组件不要去定义、注入

  • 用时注入:在真正渲染的时候注入

    每个页面在渲染该组件时,该组件会被渲染成一个对应的占位组件,渲染流程结束后开始注入

    如点击出现的模态框、用户的权限模块、多步骤表单

合理使用setData

setData阶段:

  • 逻辑层虚拟DOM树的遍历与更新,触发组件生命周期和observer等

  • 将data从逻辑层传输到视图层

  • 视图层虚拟DOM树的更新、真实DOM元素的更新并触发页面渲染更新

setData应只用来进行渲染相关的数据更新,仅在需要进行页面内容更新时调用,并控制范围,且连续的setData调用尽可能合并,避免频繁使用

资源加载优化

  • 压缩图片大小,不需要透明背景的可考虑转化为JPEG(通常小于PNG)

  • 避免滥用image组件的widthFix和heightFix模式,会动态改变图片的宽高,可能会引起页面大范围重排,导致页面抖动

  • 图片懒加载

  • 使用图片精灵

  • 使用CDN

ScreenShot_2026-11-16_152025_938

优点 缺点 适用场景
PNG 无损压缩、质量高、支持透明 体积大,较旧的浏览器和程序可能不支持 PNG 文件 考虑到 PNG 在处理线条和颜色对比度方面的优势,使用它来呈现小的 Logo、颜色简单且对比强烈的图片或背景等
JPEG/JPG 有损压缩,通过压缩大大的减少图片的体积,调整质量级别以获得质量和文件大小的良好平衡 不支持透明度处理,透明图片需要使用 PNG 格式 用于色彩十分鲜艳的图片,比如背景图、轮播图或 Banner 图出现等
GIF 支持动画,文件体积通常都很小,支持透明 由于采用了 8 位压缩,最多只能处理 256 种颜色 展示一些无限循环的动画,比如图标、表情、广告栏等
SVG 可缩放矢量图形,文件体积更小,可压缩性更强 渲染成本比较高、学习 SVG 的成本相对来说比较高 一般作为 icon 图标
Base64 相比每次加载一张图片时发起一次 https 请求,而使用 Base64 是随着 HTML/JS/CSS 的下载,同时下载到本地,有效减少 https 请求 不适合大图,容易导致文件体积膨胀,因为 Base64 编码后,图片大小会膨胀为原文件的 4/3(由 Base64 的编码原理决定) 较小的图片,如:页面的 Logo
WebP 有损压缩与无损压缩,支持动画,支持透明 存在兼容性,支持并不普遍,在移动端 ios 13 版本之前的系统基本不支持 半透明图像、图形图案等

使用npm包

  • 不支持依赖于node.js内置库的包

  • 不支持依赖于浏览器内置的包,如Jquery

  • 不支持依赖于C++插件的包

TDesign链接:TDesign

  1. 安装:npm i tdesign-miniprogram -S --production

  2. 构建:工具中“构建npm”

  3. 移除app.json中的 "style": "v2"

  4. 引入:"usingComponents": { "t-button": "tdesign-miniprogram/button/button"}

  5. 使用:<t-button theme="primary">按钮</t-button>

骨架屏

小程序编译器右下角可以为当前页面自动生成骨架屏

微信图片_20261116152808_156_18

云开发

  • 云函数:云端运行的代码

  • 云数据:文档型数据库

  • 云存储:自带CDN加速,支持在前端直接上传/下载

  • 云托管 :不限框架和语言,常驻运行,可快速进行业务迁移

ScreenShot_2026-11-17_084658_754

优点:

  • 无需搭建服务器

  • 免登录免鉴权调用

  • 按量计费成本低

  • 统一开发多端应用

posted @ 2026-11-16 16:37  原语  阅读(5)  评论(0)    收藏  举报