微信小程序使用npm支持踩坑
前言
最近写了个CNode社区的微信小程序版本，把在微信小程序中使用npm包，踩的坑记录一下，希望能给遇到类似问题的小伙伴，提供一些思路和方向。
npm支持
从小程序基础库版本2.2.1或以上、及开发者工具1.02.1808300或以上开始，小程序支持使用npm安装第三方包。
踩坑之路
由于项目中需要格式化一些日期数据，于是选择了moment，一款JavaScript日期处理类库
首先使用命令行，安装moment
#打开小程序根目录 cdsrc npminstall--productionmoment
然后按照小程序文档往下操作，直到构建完成
于是我们迫不及待的开始使用moment
importmomentfrom'moment'; letsFromNowText=moment(newDate()-360000).fromNow(); console.log(sFromNowText); //控制台输出："6minutesago"
moment能够正常工作，但是很快我们发现英文不是我们想要的
于是我们找到moment的国际化配置，并设置全局语言为中文
importmomentfrom'moment';
moment.locale('zh-cn');
letsFromNowText=moment(newDate()-360000).fromNow();
console.log(sFromNowText);
//可是控制台，依然输出："6minutesago"
尝试输出moment.locale执行后的返回值
//...
letsLang=moment.locale('zh-cn');
console.log(sLang);
//控制台输出："en"
发现设置语言环境失败了，经过排查和翻阅小程序文档后，发现通过微信开发者工具构建npm后，并不会将语言环境相关文件拷贝到miniprogram_npm目录下，仅将入口js文件及其依赖的模块进行打包处理，进而导致加载中文语言环境失败。以下是摘自小程序文档的一段话：
构建打包分为两种：小程序npm包会直接拷贝构建文件生成目录下的所有文件到miniprogram_npm中；其他npm包则会从入口js文件开始走一遍依赖分析和打包过程（类似webpack）。
快速查看了一下moment源码，发现moment.locale方法，会从./locale/目录下加载语言环境包，于是尝试手动从node_modules/moment/目录下，将中文语言环境包，拷贝到miniprogram_npm目录下
//moment.js
//...
functionloadLocale(name){
//...
varaliasedRequire=require;
aliasedRequire('./locale/'+name);
//...
}
//...
经过调试发现，moment定义语言环境时出错，原来是由于构建npm导致入口文件(moment.js)经过打包后更名为index.js导致：Error:module"miniprogram_npm/moment/moment"isnotdefined
//zh-cn.js
(function(global,factory){
typeofexports==='object'&&typeofmodule!=='undefined'&&typeofrequire==='function'
?factory(require('../moment'))
:typeofdefine==='function'&&define.amd
?define(['../moment'],factory)
:factory(global.moment);
})(this,function(moment){
'usestrict';
varzhCn=moment.defineLocale('zh-cn',{
//...
});
returnzhCn;
});
果然手动将'../moment'统一改为'../index'，然后重新执行
importmomentfrom'moment';
moment.locale('zh-cn');
letsFromNowText=moment(newDate()-360000).fromNow();
console.log(sFromNowText);
//现在控制台，输出："6分钟前"
大功告成，nice!但也别忘了回过头来，总结一下导致这几个问题的原因：
- 构建npm会将npm包的入口文件（eg:moment.js），打包后更名为index.js
- 构建npm仅将npm包的入口js文件及其依赖的模块进行打包处理，并不会将该npm包下一些可选的文件（eg:moment的语言环境包）拷贝到miniprogram_npm目录下
miniprogram_npm、构建npm及更多npm支持相关信息，请翻阅小程序文档-npm支持
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。