编者按

近期一个云开发项目有生成Word文档的需求，经过搜索，发现并没有小程序·云开发有关生成word文档的案例，因为本人还是本科生且非科班出身，一路摸着石头过河，遇到了不少困难，期间还试图向社区的大佬们求助；花了两天时间才搞定这一百行代码，现在分享给大家。

代码有些糙，希望大佬们不要嫌弃。

一、安装云函数依赖officegen、fs

工欲善其事必先利其器，我们知道云函数代码运行在云端Node.js环境中，因此，理论上来说，Node.js能做的事情，小程序·云开发的云函数基本上也能做到。officegen是Github上一款生成微软Office文档的工具，包括.docx、.xlsx、.pptx三种文件，由于我只用了.docx，本文将以Word文件为例。

https://github.com/Ziv-Barber/officegen

1. 首先我们在微信开发者工具中 新建一个云函数 => 右键云函数名 => 在终端中打开

2. npm安装依赖officegen和fs，为了方便本地调试云函数，我们这里也安装wx-server-sdk。

代码如下，请逐个安装，如果安装有问题，可以自行搜索“npm”或“npm taobao 镜像” ；这里不再赘述。

    npm i officegen
    npm i fs
    npm i wx-server-sdk

3. 在云函数index.js开头写下以下代码，引用我们刚刚安装的包。

    const cloud = require('wx-server-sdk')
    const officegen = require('officegen');
    const fs = require('fs');
    const docx = officegen('docx');

二、创建Word文档的内容

文档地址： https://github.com/Ziv-Barber/officegen/blob/master/manual/docx/README.md

1. 首先我们根据文档定义（Ctrl CV）两个函数

//文档生成完成后调用，后来其实发现没啥用

    // Officegen calling this function after finishing to generate the docx document:
    docx.on('finalize', async function (written) {
      console.log('Finish to create a Microsoft Word document.')
    })

    //生成文档出现问题时调用

    // Officegen calling this function to report errors:
    docx.on('error', function (err) {
      console.log(err)
    })

2. 创建段落API： docx.createP(options)

    //声明一个创建段落的变量p0bj

let pObj = docx.createP(options)

//创建一个段落并插入文本

    pObj = docx.createP({
      align: 'center'    //文字对齐方式，center、justify、right；默认为left
      indentLeft = 1440; // 段落缩进 Indent left 1 inch
      indentFirstLine = 440; // 首行缩进
    })
    pObj.addText('你要插入的文字，这里可以时变量', {
      bold: true,    //是否加粗，默认false
      font_face: 'KaiTi',    //字体，这里以“楷体为例”，如果填写了打开文档的电脑没有安装的字体名称，将使用默认字体。能不能用中文，我没试过。
      font_size: 19,    //字号
      color: '595959'   //文字颜色
    });

上述例子外，还可以添加下划线、设置斜体、超链接、分页等；还可以编辑页眉和页脚、插入图片等。详见后续代码示例或officegen文档。

3. 插入图片

这里以插入小程序码为例，直接上代码。

要注意的是officegen似乎不支持以buffer形式插入图片，因此要先将图片保存。

//首先定义一个用于保存小程序码图片的函数

    //save QR
    saveFile = function (filePath, fileData) {
      return new Promise((resolve, reject) => {
        const wstream = fs.createWriteStream(filePath);
        wstream.on('open', () => {
          const blockSize = 128;
          const nbBlocks = Math.ceil(fileData.length / (blockSize));
          for (let i = 0; i < nbBlocks; i += 1) {
            const currentBlock = fileData.slice(
              blockSize * i,
              Math.min(blockSize * (i + 1), fileData.length),
            );
            wstream.write(currentBlock);
          }
          wstream.end();
        });
        wstream.on('error', (err) => {
          reject(err);
        });
        wstream.on('finish', () => {
          resolve(true);
        });
      });
    }

//要获取小程序码，首先要修改云函数config.json文件中的云调用权限

    {
      "permissions": {
        "openapi": [
          "wxacode.getUnlimited"
        ]
      }
    }

//在云函数main中获取小程序码

    //https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/qr-code/wxacode.get.html
    const result = await cloud.openapi.wxacode.getUnlimited({
      page: 'pages/check/check',    //小程序页面地址，必须是线上版本中存在的页面的完整地址
      scene: '',    //小程序码参数
      width: 240,    //小程序码的宽度（是个正方形）
    })
    const QRcode = result.buffer
    await saveFile('/tmp/qr.jpg', QRcode); // 这里的fileData是Buffer类型，关于路径会在第三部分生成Word文件中解释。

//将图片插入到文档中

    pObj = docx.createP()    //创建段落
    pObj.options.indentFirstLine = 440;     //首行缩进
    pObj.addImage('/tmp/qr.jpg', {  //图片文件路径
      cx: 140,    //长度
      cy: 140    //宽度
    });

三、生成Word文件

文档内容完成后，就可以生成文档了。officegen似乎只能生成文件，没有文件buffer的接口，而要上传到小程序·云开发的云存储中，只能使用Buffer或fs.ReadStream，怎么办呢？先把文件保存下来再读取呗。

首先提一下云函数运行环境

https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/mechanism.html

云函数运行在云端 Linux 环境中，一个云函数在处理并发请求的时候会创建多个云函数实例，每个云函数实例之间相互隔离，没有公用的内存或硬盘空间。云函数实例的创建、管理、销毁等操作由平台自动完成。每个云函数实例都在 /tmp 目录下提供了一块 512MB 的临时磁盘空间用于处理单次云函数执行过程中的临时文件读写需求，需特别注意的是，这块临时磁盘空间在函数执行完毕后可能被销毁，不应依赖和假设在磁盘空间存储的临时文件会一直存在。如果需要持久化的存储，请使用云存储功能。

因此，我们将文件保存在/tmp路径下，文件名随便起，这里我取为exampl.docx。生成文档的代码如下：

  // Let's generate the Word document into a file:
  let out = fs.createWriteStream('/tmp/example.docx')
  // Async call to generate the output file:
  docx.generate(out)

理论上来说，我们文档生成完毕后，通过fs.ReadFileStream读取文件调用cloud.uploadFile()即可上传到云存储

    const fileStream = fs.createReadStream('/tmp/example.docx')
    return await cloud.uploadFile({
      cloudPath: '/tmp/example.docx',
      fileContent: fileStream,
    })

而在测试过程中我发现，云端测试时，云函数调用超时。而后使用本地调试查看问题出在何处。

云函数本地调试的方法不再赘述，看这里即可。https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/local-debug.html

通过本地调试，发现cloud.uplodaFile()的网络请求始终时挂起(pending)状态，没有传输数据。

经过一天的调试，通过监听文件，发现officegen生成文件完成，执行了我们开头复制粘贴的生成文档后执行的docx.on("finalize",)函数，打印文档生成成功的日志后，仍有文件变动，也就是说，文件并没有生成完毕。这就导致了后续步骤的失败。

当时调试的界面我没有保存，就贴一下fs监听文件的代码吧。

  let watcherObj = '/tmp/example.docx'
  //eventType 可以是 'rename' 或 'change'； 当改名或出现或消失的时候触发rename； recursive:是否监听到内层子目录，默认false；
  try {
      let myWatcher = fs.watch(watcherObj,{encoding:'utf8',recursive:true},(event,filename) => {
          if(event == 'change'){
              console.log("触发change事件")
          }
          console.log(event)
          //encoding:文件名编码格式，buffer、默认：utf8等；filename有可能为空
          if(filename){
              console.log('filename: ' + filename)
          }
      })
      //change 事件会触发多次  
      myWatcher.on('change',function(err,filename){  
          console.log(filename + '发生变化');  
      }); 
      //50秒后 关闭监视  
      setTimeout(function(){  
          myWatcher.close()
      },5000);
  } catch (error) {
      console.log('文件不存在！！')
  }

为解决这一问题，我最先想到了await，结果发现await对officegen生成文档的接口并不起作用；最终我用了最原始的笨办法：用setTimeout等一会儿再读取文件，大佬们有更好的解决方案还请赐教。

  return new Promise((resolve, reject) => {
    setTimeout(async function () {
      let data = fs.readFileSync('/tmp/example.docx');
      let bufferData = new Buffer.from(data, 'base64');
      console.log(bufferData);
      setTimeout(async function () {
        resolve(await cloud.uploadFile({
          cloudPath: varpath,
          fileContent: bufferData,
        }));
      }, 1000);    //等文件再读1秒
    }, 6300);    //等文件再写一会儿。根据自己的需求调试后确定等待时长，要预留出一定时间确保文档完全生成完毕。
  })    //最终返回内容为文件云存储中的CloudID。

四、完整核心代码

const cloud = require('wx-server-sdk')
const officegen = require('officegen');
const fs = require('fs');
const docx = officegen('docx');
cloud.init({
  env: '这里填入你的云环境'
})
// Officegen calling this function after finishing to generate the docx document:
docx.on('finalize', async function (written) {
  console.log('Finish to create a Microsoft Word document.')
})
// Officegen calling this function to report errors:
docx.on('error', function (err) {
  console.log(err)
})
//save QR
saveFile = function (filePath, fileData) {
  return new Promise((resolve, reject) => {
    const wstream = fs.createWriteStream(filePath);
    wstream.on('open', () => {
      const blockSize = 128;
      const nbBlocks = Math.ceil(fileData.length / (blockSize));
      for (let i = 0; i < nbBlocks; i += 1) {
        const currentBlock = fileData.slice(
          blockSize * i,
          Math.min(blockSize * (i + 1), fileData.length),
        );
        wstream.write(currentBlock);
      }
      wstream.end();
    });
    wstream.on('error', (err) => {
      reject(err);
    });
    wstream.on('finish', () => {
      resolve(true);
    });
  });
}
// 云函数入口函数
exports.main = async (event, context) => {
  var time = new Date()
  var filePath = 'exportVoluntaryData'
  var fileName = "zyzm" + Date.parse(new Date()) + '.docx'
  var varpath = filePath + '/' + fileName
  //get QRcode
  const result = await cloud.openapi.wxacode.getUnlimited({
    page: 'pages/check/check',
    scene: item._id,
    width: 240,
  })
  const QRcode = result.buffer
  await saveFile('/tmp/qr.jpg', QRcode);
  // Add a Footer:
  var footer = docx.getFooter().createP();
  footer.addText('XXXX证明_' + item._id, {
    font_size: 10
  });
  footer = docx.getFooter().createP();
  footer.addText(time.toString(), {
    font_size: 10
  });
  //下方开始文档每一页的循环
  for (var i in item.volunteerInfo) {
    //标题
    let pObj = docx.createP({
      align: 'center'
    })
    pObj.addText('XXX证明', {
      bold: true,XXX
      font_face: 'KaiTi',
      font_size: 19,
      color: '595959'
    });
    //此处省略了一些正文内容
    pObj = docx.createP()
    pObj.options.indentFirstLine = 440;
    pObj.addText('微信扫描下方小程序码，可核验此证明。', {
      font_face: 'FangSong',
      font_size: 12,
      color: '595959',
      italic: true,
    });
    pObj = docx.createP()
    pObj.options.indentFirstLine = 440;
    pObj.addImage('/tmp/qr.jpg', {
      cx: 140,
      cy: 140
    });
    pObj = docx.createP()
    pObj = docx.createP({
      align: 'right'
    })
    pObj.addText('落款', {
      font_face: 'FangSong',
      font_size: 15,
      color: '595959'
    });
    if (i != ((item.volunteerInfo).length - 1)){
      docx.putPageBreak()   //分页
    }
  }
  // Let's generate the Word document into a file:
  let out = fs.createWriteStream('/tmp/example.docx')
  // Async call to generate the output file:
  docx.generate(out)
  return new Promise((resolve, reject) => {
    setTimeout(async function () {
      let data = fs.readFileSync('/tmp/example.docx');
      let bufferData = new Buffer.from(data, 'base64');
      console.log(bufferData);
      setTimeout(async function () {
        resolve(await cloud.uploadFile({
          cloudPath: varpath,
          fileContent: bufferData,
        }));
      }, 1000);
    }, 6300);
  })
}

本人非计算机相关专业本科生，且本文大部分内容为手打，难免会有差错和疏漏，还请各位指教。

希望本文对你有所帮助。

Soochow University. HaoChen.