微信小程序入门
介绍
特点:
-
轻量化、即用性
-
加载速度快于HTML5
-
无需适配
-
微信生态整合
-
云端即时更新,无需审核发布新版本
-
rem、flex布局
2017-至今
小程序语言:
-
wxml:描述页面结构
-
json:设置文件、数据存储和网络请求
-
javascript:业务处理
-
wxss:页面样式
注册
一个邮箱只能申请一个小程序

下载
输入注册的APPID

项目搭建
-
字体常用为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
目录结构

// 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数组中写入新的页面即可生成新的页面文件夹:

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

编译页面
方式一:把需要显示的页面放在app.json文件的pages数组的第一项
方式二:在编译中修改启动页,优先级高于方式一

修改页面
获取全局值
如果需要全局修改数据,则在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;
}

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]
}
})

页面布局
| 名称 | 特点 | 缺点 |
|---|---|---|
| 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树构建等

优点:
-
不容易阻塞,减少卡顿
-
无需为每个页面新建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%;
}

事件机制
事件将视图层传递到逻辑层
-
冒泡事件:
- 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
-
地理位置
-
开通授权
![ScreenShot_2026-11-13_164728_211]()
-
配置
app.json中permission选项和requiredPrivateInfos配置项"permission": { "scope.userFuzzyLocation": { "desc": "你的地理位置信息将用于xxxx功能" } }, "requiredPrivateInfos": [ "getFuzzyLocation" ],
用户信息
调用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
-
获取推理环境
wx.getInferenceEnvInfo({ success: res => { const {version, supportedModelFormats} = res; } fail: err => { console.error(err) } }) -
创建推理接口
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));
组件
-
在根目录中创建components文件夹放置自定义组件文件夹
-
在components创建文件夹后右键点击“新建component”快速创建文件
此时创建出来的js文件是Component而不是Page
-
引入自定义组件:在页面的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可以包含属性、数据、生命周期函数、方法
使用步骤:
-
创建Behavior文件
module.exports = Behavior({ //属性节点 properties: { }, //私有数据节点 data: { userName: '张三', userAge: 10, }, //其它节点 methods: { updataInfo() { this.setData({ userName: '王五', userAge: 20 }) wx.showToast({ title: '修改成功', mask: true }) }, }, }) -
在自定义组件的js文件中引入Behavior
const my_behavior = require("../../behavior/my-behavior.js"); Page({ data: { showImg: '' }, behaviors: [ my_behavior ], }) -
在自定义组件的xml在使用Behavior数据和方法
<view style="text-align: center;"> my_behaviors中的数据: 姓名: {{userName}} 年龄: {{userAge}} </view> -
在父组件的json文件中引入自定义组件
-
在父组件中引入并使用自定义组件
父组件给子组件传递数据
<!-- 父组件 -->
<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"
]
}
]
}

独立分包:可以直接启动的分包
普通分包必须依赖于主包才能运行,独立分包可以在不下载的情况下独立运行
独立分包和主包及普通分包之间是相互隔绝的,不能互相引用彼此的资源
如:电商小程序中的促销活动是临时的,需要频繁更新,因此可以将促销模块设计为一个独立分包,这样可以在促销活动期间只需加载该分包,在活动结束时卸载
只需在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

| 优点 | 缺点 | 适用场景 | |
|---|---|---|---|
| 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
-
安装:
npm i tdesign-miniprogram -S --production -
构建:工具中“构建npm”
-
移除app.json中的
"style": "v2" -
引入:
"usingComponents": { "t-button": "tdesign-miniprogram/button/button"} -
使用:
<t-button theme="primary">按钮</t-button>
骨架屏
小程序编译器右下角可以为当前页面自动生成骨架屏

云开发
-
云函数:云端运行的代码
-
云数据:文档型数据库
-
云存储:自带CDN加速,支持在前端直接上传/下载
-
云托管 :不限框架和语言,常驻运行,可快速进行业务迁移

优点:
-
无需搭建服务器
-
免登录免鉴权调用
-
按量计费成本低
-
统一开发多端应用

浙公网安备 33010602011771号