微信小程序 - npm支持踩坑

前言

最近写了个CNode 社区的微信小程序版本，把在微信小程序中使用npm包，踩的坑记录一下，但愿能给遇到相似问题的小伙伴，提供一些思路和方向。

npm 支持

从小程序基础库版本 2.2.1 或以上、及开发者工具 1.02.1808300 或以上开始，小程序支持使用 npm 安装第三方包。

踩坑之路

1. 因为项目中须要格式化一些日期数据，因而选择了moment，一款JavaScript 日期处理类库

2. 首先使用命令行，安装moment

   # 打开小程序根目录
   cd src
   npm install --production moment

3. 而后按照小程序文档往下操做，直到构建完成

4. 因而咱们火烧眉毛的开始使用moment

   import moment from 'moment';
   
   let sFromNowText = moment(new Date() - 360000).fromNow();
   console.log(sFromNowText);
   
   // 控制台输出："6 minutes ago"

5. moment可以正常工做，可是很快咱们发现英文不是咱们想要的

6. 因而咱们找到moment的国际化配置，并设置全局语言为中文

   import moment from 'moment';
   moment.locale('zh-cn');
   
   let sFromNowText = moment(new Date() - 360000).fromNow();
   console.log(sFromNowText);
   
   // 但是控制台，依然输出："6 minutes ago"

7. 尝试输出moment.locale执行后的返回值

   // ...
   let sLang = moment.locale('zh-cn');
   console.log(sLang);
   
   // 控制台输出："en"

8. 发现设置语言环境失败了，通过排查和翻阅小程序文档后，发现经过微信开发者工具构建npm后，并不会将语言环境相关文件拷贝到miniprogram_npm目录下，仅将入口js文件及其依赖的模块进行打包处理，进而致使加载中文语言环境失败。如下是摘自小程序文档的一段话：

   构建打包分为两种：小程序 npm 包会直接拷贝构建文件生成目录下的全部文件到 miniprogram_npm 中；其余 npm 包则会从入口 js 文件开始走一遍依赖分析和打包过程（相似 webpack）。

9. 快速查看了一下moment源码，发现moment.locale方法，会从./locale/目录下加载语言环境包，因而尝试手动从node_modules/moment/目录下，将中文语言环境包，拷贝到miniprogram_npm目录下

   // moment.js
   // ...
   function loadLocale(name) {
     // ...
     var aliasedRequire = require;
     aliasedRequire('./locale/' + name);
     // ...
   }
   // ...

10. 通过调试发现，moment定义语言环境时出错，原来是因为构建npm致使入口文件(moment.js)通过打包后改名为index.js致使：Error: module "miniprogram_npm/moment/moment" is not defined

    // zh-cn.js
    (function(global, factory) {
      typeof exports === 'object' && 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;
    });

11. 果真手动将'../moment'统一改成'../index'，而后从新执行

    import moment from 'moment';
    moment.locale('zh-cn');
    
    let sFromNowText = moment(new Date() - 360000).fromNow();
    console.log(sFromNowText);
    
    // 如今控制台，输出："6 分钟前"

12. 大功告成，nice! 但也别忘了回过头来，总结一下致使这几个问题的缘由：

    1. 构建npm会将npm包的入口文件（eg: moment.js），打包后改名为index.js
    2. 构建npm仅将npm包的入口js文件及其依赖的模块进行打包处理，除此以外的文件（eg: moment的语言环境包）并不会作打包处理

miniprogram_npm 、 构建npm及更多npm支持相关信息，请翻阅 小程序文档-npm支持