前言
Underscore.js 是一個相當精簡的函式庫,壓縮後僅約 4KB。它提供了 100 多個函式,包含常用的 map、filter、invoke,還有函式綁定、JavaScript 模板功能、快速索引建立、強型別相等測試等更專業的輔助函式,彌補了標準庫的不足,大幅方便了 JavaScript 開發。
但微信小程序無法直接透過 require('underscore.js') 呼叫。
微信小程序的模組化機制
微信小程序的運行環境支援 CommonJS 模組化,透過 module.exports 暴露物件,並以 require 取得物件。
微信小程序 Quick Start 中的 utils/util.js:
function formatTime(date) { var year = date.getFullYear() var month = date.getMonth() + 1 var day = date.getDate() var hour = date.getHours() var minute = date.getMinutes() var second = date.getSeconds(); return [year, month, day].map(formatNumber).join('/') + ' ' + [hour, minute, second].map(formatNumber).join(':') } function formatNumber(n) { n = n.toString() return n[1] ? n : '0' + n } module.exports = { formatTime: formatTime }
pages/log/log.js
var util = require('../../utils/util.js') Page({ data: { logs: [] }, onLoad: function () { this.setData({ logs: (wx.getStorageSync('logs') || []).map(function (log) { return util.formatTime(new Date(log)) }) }) } })
原因分析
Underscore 的 CommonJS 模組導出程式碼如下:
// Export the Underscore object for **Node.js**, with // backwards-compatibility for the old `require()` API. If we're in // the browser, add `_` as a global object. if (typeof exports !== 'undefined') { if (typeof module !== 'undefined' && module.exports) { exports = module.exports = _; } exports._ = _; } else { root._ = _; }
這裡 exports、module 都必須有定義才能導出。但經過測試發現,微信小程序的運行環境裡 exports 與 module 並未定義。
//index.js //獲取應用實例 var app = getApp(); Page({ onLoad: function () { console.log('onLoad'); var that = this; console.log('typeof exports: ' + typeof exports); console.log('typeof module: ' + typeof exports); var MyClass = function() { } module.exports = MyClass; console.log('typeof module.exports: ' + typeof module.exports); } })

解決方法
修改 Underscore 的程式碼,註解掉原有的模組導出語句,改用 module.exports = _ 強制導出。
/* // Export the Underscore object for **Node.js**, with // backwards-compatibility for the old `require()` API. If we're in // the browser, add `_` as a global object. if (typeof exports !== 'undefined') { if (typeof module !== 'undefined' && module.exports) { exports = module.exports = _; } exports._ = _; } else { root._ = _; } */ module.exports = _;
/* // AMD registration happens at the end for compatibility with AMD loaders // that may not enforce next-turn semantics on modules. Even though general // practice for AMD registration is to be anonymous, underscore registers // as a named module because, like jQuery, it is a base library that is // popular enough to be bundled in a third party lib, but not be part of // an AMD load request. Those cases could generate an error when an // anonymous define() is called outside of a loader request. if (typeof define === 'function' && define.amd) { define('underscore', [], function() { return _; }); } */
使用 Underscore.js
//index.js var _ = require( '../../libs/underscore/underscore.modified.js' ); //獲取應用實例 var app = getApp(); Page( { onLoad: function() { //console.log('onLoad'); var that = this; var lines = []; lines.push( "_.map([1, 2, 3], function(num){ return num * 3; });" ); lines.push( _.map( [ 1, 2, 3 ], function( num ) { return num * 3; }) ); lines.push( "var sum = _.reduce([1, 2, 3], function(memo, num){ return memo + num; }, 0);" ); lines.push( _.reduce( [ 1, 2, 3 ], function( memo, num ) { return memo + num; }, 0 ) ); lines.push( "var even = _.find([1, 2, 3, 4, 5, 6], function(num){ return num % 2 == 0; });" ); lines.push( _.find( [ 1, 2, 3, 4, 5, 6 ], function( num ) { return num % 2 == 0; }) ); lines.push( "_.sortBy([1, 2, 3, 4, 5, 6], function(num){ return Math.sin(num); });" ); lines.push( _.sortBy( [ 1, 2, 3, 4, 5, 6 ], function( num ) { return Math.sin( num ); }) ); lines.push( "_.indexOf([1, 2, 3], 2);" ); lines.push( _.indexOf([1, 2, 3], 2) ); this.setData( { text: lines.join( '\n' ) }) } })

總結
關鍵在於微信小程序的環境裡 exports 與 module 不會同時存在,導致 UMD 判斷失效。只要手動改寫導出語句為 module.exports = _,就能正常使用這個實用函式庫了。