前言
最近写了个CNode 社区的微信小程序版本,把在微信小程序中使用npm包,踩的坑记录一下,希望能给遇到类似问题的小伙伴,提供一些思路和方向。
npm 支持
从小程序基础库版本 2.2.1 或以上、及开发者工具 1.02.1808300 或以上开始,小程序支持使用 npm 安装第三方包。
踩坑之路
由于项目中需要格式化一些日期数据,于是选择了moment,一款 日期处理类库
首先使用命令行,安装moment
# 打开小程序根目录 cd src npm install --production moment
然后按照小程序文档往下操作,直到构建完成
于是我们迫不及待的开始使用moment
import moment from \'moment\'; let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 控制台输出:\"6 minutes ago\"
moment能够正常工作,但是很快我们发现英文不是我们想要的
于是我们找到moment的国际化配置,并设置全局语言为中文
import moment from \'moment\'; moment.locale(\'zh-cn\'); let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 可是控制台,依然输出:\"6 minutes ago\"
尝试输出moment.locale执行后的返回值
// ... let sLang = 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
// ...
function loadLocale(name) {
// ...
var aliasedRequire = require;
aliasedRequire(\'./locale/\' + name);
// ...
}
// ...
经过调试发现,moment定义语言环境时出错,原来是由于构建npm导致入口文件(moment.js)经过打包后更名为index.js导致:Error: module \"miniprogram_npm/moment/moment\" is not defined
// zh-cn.js
(function(global, factory) {
typeof exports === \' \' && typeof module !== \'undefined\' && typeof require === \'function\'
? factory(require(\'../moment\'))
: typeof define === \'function\' && define.amd
? define([\'../moment\'], factory)
: factory(global.moment);
})(this, function(moment) {
\'use strict\';
var zhCn = moment.defineLocale(\'zh-cn\', {
// ...
});
return zhCn;
});
果然手动将\'../moment\'统一改为\'../index\',然后重新执行
import moment from \'moment\'; moment.locale(\'zh-cn\'); let sFromNowText = moment(new Date() - 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支持
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。
继续阅读与本文标签相同的文章
DNS服务到底是什么
谷歌的搜索和AI的领导即将卸任
-
黄顺昌:如何到达行业专家水平
2026-05-19栏目: 教程
-
阿里研究员:测试稳定性三板斧,我怎么用?
2026-05-19栏目: 教程
-
马斯克表态:为NASA制造载人龙飞船是SpaceX的首要任务
2026-05-19栏目: 教程
-
英伟达也要进军移动端!推出安卓版GeForceNow云游戏服务
2026-05-19栏目: 教程
-
独处不再孤单。看,傻强向你招手呢!
2026-05-19栏目: 教程
