強烈推薦的幾個簡單又實用微信小程式開發小技巧

微信小程式開發專欄今天強烈推廣的幾簡單又實用個微信小程式開發小技巧。

前段時間在下開發了個微信小程序，開發過程中總結了一些我覺得對我有用的小技巧，提煉出來，相當於一個總結複盤，也希望可以幫助大家。如果對大家確實有幫助，別忘了按讚哦 

1. 微信開發者工具版本：1.03.2006090#（2020-06-19）
2. #基礎庫版本： v2.12.1 (2020-08-04)

1. 開發中可能遇到的坑以及Tips

# 本來想寫個小技巧的，結果我總結了一堆坑，沒上手之前完全想像不到微信小程式的開發體驗是如此之差、如此之爛，從微信開發者工具到所謂的「全新語言」，都有一種濃濃的半成品的five 即視感，實在讓我emmm.... 另外我發現網上的小程序文章大部分都是如何使用和如何避坑的實用文，而不是技巧文，這也從側面反映了小程式的坑多。

在微信小程式原生開發過程中，我不斷發出這樣的疑問「為什麼堂堂技術人才多如牛毛的騰訊，會推出如此laji」，很多弱智反人類的地方，在兩三年前社區就已經提出來，官方回應已經反饋正在修復中，但幾年過去了，還是沒有音信，官方回應仍然是一句冷冰冰的“已反饋”

1. 微信開發者工具經常熱更新不起作用甚至白屏，重新編譯也不行，只能強行退出後再次打開；
2. 跟上一條類似，有時候一點樣式出錯，預覽整個都白屏，調試器裡也不說哪裡的問題，直接就給你棄療不顯示，重新編譯也無法解決問題，只能強行退出後再次打開；
3. 跟上一條類似，調試器裡報的錯經常沒什麼用，驢頭不對馬嘴，讓人很難定位問題；
4. Android 端自訂Tabbar 在下拉刷新的時候，也會跟著螢幕一起往下移，而且是無法繞過的Bug，自訂Tabbar 樣式都寫好了的我又改成自備的Tabbar 了！
5. import 的路徑不支援絕對路徑，例如你希望引用utils/fetch.js，在不管多深的元件裡面​​你都要慢慢../ 點到根目錄，同樣.wxss 檔案@import 也只能使用相對路徑，所以就會出現../ ../../../../../utils/fetch.js 這種東西;
6. 靜態資源路徑不能有漢字，有漢字就無法載入；
7. .wxs 檔案不支援ES6，只能使用蹩腳的ES5 寫法；
8. .wxml 中只能引入.wxs 文件不能引入.js 檔案？ ？ ？
9. 範本{{}} 中連方法都無法執行，只能處理簡單的運算如 - * /，如果遇到資料需要filter 的場景，需要在.js 檔案中預先格式化好再一個個setData，例如經常寫的[2,3,4].includes( type)，居然都跑不起來！
10. .wxs 檔案中無法使用Date 對象，所以不能new Date()，只能使用蹩腳的getDate 方法，正規也是一樣，產生正規物件需要使用getRegExp 函數getRegExp(pattern[, flags]);
11. .wxs中可以呼叫其它.wxs 文件，並且只能require 呼叫.wxs 文件，引入的文件必須使用相對路徑；
12. setData

#####連一個物件合併都懶得做，如果###data: {a: {b: 1, c: 1}}###，那麼###setData({a: {b: 2}})###就會失去###a.c### 的值，真是讓人火冒三丈啊，還要###setData({['a.b': 2]})### 這樣才行；##### #IOS 上###Date### 物件取得任意時間參數例如###getDay###、###getTime### 都會為NaN，是因為IOS 的Date 建構子不支援###2018-04 -26### 這種格式的日期，必須轉換為###2018/04/26### 這種格式才會顯示正常；######開發版小程式有時候請求莫名其妙發不出去，右上角三個點enable debug 打開「開發調試」之後就莫名其妙能發出去請求了，在多部手機上都是這樣，不明真相。 #########2. 微信請求Promise 化######2.1 使用現成的函式庫######安裝Promise 函式庫wx-promise-pro，記得一定要帶###-s ### 或###--production###，要不然就無法建構成功。 ###

npm i -S wx-promise-pro复制代码

###然後在 ###app.js### 中：###

import { promisifyAll } from 'wx-promise-pro'promisifyAll()  // promisify all wx apiApp({ ... })复制代码

###之後就可以正常使用了：###

wx.pro.showLoading({    title: '加载中',    mask: true})
  .then(() => console.log('in promise ~'))复制代码

2.2 自己实现

其实我们可以自己来实现一个这样的库，原理很简单，以原生 API 的 wx.request 为例：

// 原生 API 使用方式wx.request({    url: '',     // 请求的 url
    data: {},    // 参数
    method: '',  // post、get
    success: res => {        // 请求成功回调函数，res为回调参数
    },    fail: res => {        // 请求失败回调函数，res为回调参数
    }
})复制代码

如果我们将其 Promise 化，应该的调用方式希望是：

// Promise 化后的期望使用方式wx.pro.request({    url: '',     // 请求的 url
    data: {},    // 参数
    method: ''   // post、get})
  .then(res => {      // 请求成功回调函数，res为回调参数
  })
  .catch(res => {      // 请求失败回调函数，res为回调参数
  })复制代码

并且 then 函数返回的是一个 Promise 对象，让这个函数可以不断链式调用下去，所以首先需要 new 出来一个 Promise 对象：

function request(opt) {    return new Promise((resolve, reject) => {
        wx.request({
            ...opt,            success: res => { resolve(res)},            fail: res => {reject(res)}
        })
    })
}复制代码

这里代码我们可以进一步改进，由于 success、fail 这里传入的参数只是由 resolve、reject 方法执行了下，所以可以直接传入 resolve、reject 方法即可。

另外，由于其他小程序原生 API 格式一致，所以我们可以使用柯里化方法，来将其他需要进行 Promise 化的 API 进行处理：

function promisify(api) {    return (opt = {}) => {        return new Promise((resolve, reject) => {
            api({
                ...opt,                fail: reject,                success: resolve
            })
        })
    }
}复制代码

然后，将柯里化方法执行的结果作为新的 Promise 化的 API 挂载到 wx.pro 对象上：

// 将指定 API 进行 Promise 化wx.pro.request = promisify(wx.request)// 使用wx.pro.request({...})
    .then(...)复制代码

然后为了方便我们使用其他方法，可以循环将 wx 对象上可以被 Promise 化的方法比如 request、scanCode、showToast、getUserInfo 等一一挂载到 wx.pro 对象上，使用时可以直接 wx.pro.xx，由于这个方法执行返回的是一个 Promise 对象，因此可以像其它 Promise 化的对象那样使用。

事实上，不知不觉，我们就自己实现了 wx-promise-pro 的源码，这个库的核心代码也就是上面那这几行 

2.3 在项目中使用

有了上面的工具后，我们可以将其使用在项目中，为了不在项目中遍布 wx.request 或 wx.pro.request 这里可以简单进行封装，新建两个文件如下：

// utils/api/fetch.js 封装请求方法、请求拦截器const app = getApp()const BaseUrl = 'http://172.0.0.1:7300/mock'const TokenWhiteList = [    '/app/user/get-by-code'     // 不需要鉴权的api手动添加到这里]/**
 * 设置请求拦截器
 * @param params 请求参数
 */const fetch = (params = {}) => {    // 拦截器逻辑
    if (!TokenWhiteList.includes(params.url)) {
        params.header = {            'content-type': 'application/json',             // 默认值
            'token': app.globalData.token || ''
        }
    }    if (params.url.startsWith('/')) {    // 拼接完整URL
        params.url = BaseUrl + params.url
    }    // 返回promise
    return wx.pro.request({ ...params })
      .then(({ data: { code, message, data } }) => {          // ... 各种异常情况的逻辑处理
          // 与后端约定 code 20000 时正常返回
          if (code === 20000) return Promise.resolve(data)          return Promise.reject(message)
      })
}export { fetch }复制代码

然后再将所有 API 封装到单独的文件中集中管理：

// utils/api/apis.js 封装所有请求 APIimport { fetch } from './fetch'/* 根据微信code获取用户信息 */const appUserGetByCode = ({ code } = {}) => fetch({    url: '/app/user/get-by-code',    data: { code }
})/* 扫码登录 */const appUserQrLogin = ({ qrCode } = {}) => fetch({    method: 'POST',    url: '/app/user/qr-login',    data: { qrCode }
})/* 个人信息 */const appUserInfo = () => fetch({    url: '/app/user/info'})/* 系统参数获取，数据字典 */const appSysParamListByParam = () => fetch({    url: '/app/sys-param/list-by-param'})/* 数据字典所有 */const appSysParamListAll = () => fetch({    url: '/app/sys-param/list-all'})export {
    appSysParamListAll,   // 数据字典所有
    appSysParamListByParam,   // 系统参数获取，数据字典
    appUserGetByCode,   // 根据微信code获取用户信息
    appUserQrLogin,   // 扫码登录
    appUserInfo   // 个人信息}复制代码

在要使用 API 的地方就可以这样引入：

import * as Api from '../../utils/api/apis.js'   // 相对路径// 使用方式Api.appSysParamListAll()
  .then(({ dataList }) => this.upData({ sysParamList: dataList }))
  .then(() => {      const keyList = this.data.sysParamList.map(T => T.key)      this.upData({
          keyList,          formData: { keys: keyList }
      })
  })复制代码

使用方式就很舒服，这里使用到了 upData，就是下面我要介绍的内容，是在下非常推介的小程序工具～ 

3. setState 修改 data 中想修改对象的属性

在小程序中，data 是不能直接操作的，需要使用 setData 函数。鉴于微信小程序开发时 setData 的使用体验十分蹩脚，我使用了个库函数 wx-updata，这个库函数在开发的时候对我很有帮助，这里特意推介给大家。

3.1 为什么要使用 wx-updata

你在使用 setData 的时候，是不是有时候觉得很难受，举个简单的例子：

// 你的 datadata: {    name: '蜡笔小新',    info: { height: 140, color: '黄色' }
}复制代码

如果要修改 info.height 为 155，使用 setData 要怎么做呢：

// 这样会把 info 里其他属性整不见了this.setData({ info: { height: 155 } })// 你需要取出 info 对象，修改后整个 setDataconst { info } = this.data
info.height = 155this.setData({ info })复制代码

似乎并不太复杂，但如果 data 是个很大的对象，要把比较深且不同的对象、数组项挨个改变：

data: {    name: '蜡笔小新',    info: {        height: 140, color: '黄色',        desc: [{ age: 8 }, '最喜欢大象之歌', '靓仔', { dog: '小白', color: '白色' }]
    }
}复制代码

比如某个需求，需要把 info.height 改为 155，同时改变 info.desc 数组的第 0 项的 age 为 12，第 3 项的 color 为灰色呢？

// 先取出要改变的对象，改变数字后 setData 回去const { info } = this.data
info.height = 155info.desc[0].age = 12info.desc[3].color = '灰色'this.setData({ info })// 或者像某些文章里介绍的，这样可读性差，也不太实用this.setData({    'info.height': 155,    'info.desc[0].age': 12,    'info.desc[3].color': '灰色'})复制代码

上面这两种方法，是我们平常小程序里经常用的，和其他 Web 端的框架相比，就很蹩脚，一种浓浓的半成品感扑面而来，有没有这样一个方法：

this.upData({    info: {        height: 155,        desc: [{ age: 12 }, , , { color: '灰色' }]
    }
})复制代码

这个方法会帮我们深度改变嵌套对象里对应的属性值，跳过数组项里不想改变的，只设置我们提供了的属性值、数组项，岂不是省略了一大堆蹩脚的代码，而且可读性也极佳呢。

这就是为什么我在上线的项目中使用 wx-updata，而不是 setData

wx-updata 的原理其实很简单，举个例子：

this.upData({    info: {        height: 155,        desc: [{ age: 12 }]
    }
})// 会被自动转化为下面这种格式，// this.setData({//    'info.height': 155,//    'info.desc[0].age': 12,// })复制代码

原来这个转化工作是要我们自己手动来做，现在 wx-updata 帮我们做了，岂不美哉！

3.2 wx-updata 使用方式

在一般情况下，我们可以将方法直接挂载到 Page 构造函数上，这样就可以在 Page 实例中像使用 setData 一样使用 upData 了：

// app.js 中挂载import { updataInit } from './miniprogram_npm/wx-updata/index'  // 你的库文件路径App({
    onLaunch() {
        Page = updataInit(Page, { debug: true })
    }
})// 页面代码中使用方式this.upData({    info: { height: 155 },    desc: [{ age: 13 }, '帅哥'],    family: [, , [, , , { color: '灰色' }]]
})复制代码

有的框架可能在 Page 对象上进行了进一步修改，直接替换 Page 的方式可能就不太好了，wx-updata 同样暴露了工具方法，用户可以在页面代码中直接使用工具方法进行处理：

// 页面代码中import { objToPath } from './miniprogram_npm/wx-updata/index'  // 你的库文件路径Page({    data: { a: { b: 2}, c: [3,4,5]},    // 自己封装一下
    upData(data) {        return this.setData(objToPath(data))
    },    // 你的方法中或生命周期函数
    yourMethod() {        this.upData({ a: { b: 7}, c: [8,,9]})
    }
})复制代码

针对修改数组指定项的时候，可能存在的跳过数组空位的情况，wx-updata 提供了 Empty 的 Symbol 类型替位符，还有数组的对象路径方式，感兴趣可以看看 wx-updata 的文档，也可以参考 这篇介绍文章。

另外，使用了 wx-updata 也还可以使用原来的 setData，特别是有时候要清空数组时，灵活使用，可以获得更好的小程序开发体验，祝大家小程序开发愉快 

4. 使用 scss 写样式

4.1 Webstorm 配置方法

关于蹩脚的 .wxss 样式，我使用 webstorm 的 file watcher 工具把 scss 文件监听改动并实时编译成 .wxss 文件，感觉比较好用，这里给大家分享一下我的配置：

然后记得在 .gitignore 文件中加入要忽略的样式：

*.scss
*.wxss.map复制代码

这样在上传到 git 的时候，就不会上传 scss 文件了～ 当然如果你的团队成员需要 scss 的话，还是建议 git 上传的时候也加上 scss 文件。

这样设置之后，一个组件在本地的会是下面这样

其中我们需要关注的就是 .js、.json、.scss、.wxml 文件，另外的文件 .wxss 会在你改动 .scss 文件之后自动生成并更新，而 .wxss.map 是插件自动生成的映射关系，不用管。

如果不是使用 webstorm，可以直接执行命令 sass --watch index.scss:index.wxss -s expanded，命令行如果关闭，sass 命令就不会监听文件的变动然后编译，所以最好用编辑器的插件。

同理，也可以使用 less、stylus 等预编译语言。

4.2 Visual Studio Code 配置方法

万能的 VSC 当然也可以做到这个功能，搜索并下载插件 easy sass，然后在 setting.json 中修改/增加配置：

"easysass.formats": [
  {    "format": "expanded",    "extension": ".wxss"
  },
  {    "format": "compressed",    "extension": ".min.wxss"
  }
]复制代码

上面 expanded 是编译生成的 .wxss 文件，下面 compressed 是压缩之后的 .wxss 样式文件，下面这个用不到可以把下面这个配置去掉，然后在 .gitignore 文件中加入要忽略的中间样式：

*.scss复制代码

当然也可以不添加，如果你的同事也是实用 scss 来开发小程序的话，其他跟上面一样，至此你就可以在小程序开发中快乐使用 scss 了～

5. 使用 iconfont 图标字体

在 Web 开发中 iconfont 可谓是最常用的灵活图标字体工具了，这里介绍一下如何在微信小程序中引入 iconfont 图标。

首先找到你想使用的图标们，点击购物车之后下载到本地。

下载到本地是一个压缩包，解压缩之后将 iconfont.css 文件复制到微信小程序的 styles 文件夹中 （在下的习惯，也可以放到你想放的地方比如 fonts），将后缀改为 .wxss

在 app.wxss 中引入样式：

@import "styles/iconfont.wxss";复制代码

然后在 .wxml 中就可以使用刚刚你添加的图标了，Web 使用 i 标签，小程序中使用 text 标签：

<text class="iconfont icon-my-edit" style="color: blue"></text>复制代码

如果后面要加新的图标，要下载新的 iconfont.css 的文件到本地重命名并覆盖，重新走一遍这个流程。

相关免费学习推荐：微信小程序开发

以上是強烈推薦的幾個簡單又實用微信小程式開發小技巧的詳細內容。更多資訊請關注PHP中文網其他相關文章！