# 操作场景

本文档将指导您在小程序开发过程中使用 npm 安装第三方依赖,web 端无需关注此部分内容。

# 前提条件

您需要先安装 Node.js (opens new window) ,确保安装包含 npm。

# 操作步骤

在云函数中我们可以引入第三方依赖来帮助我们更快的开发。云开发提供了云端安装依赖,免去了在终端手动安装依赖的工作。但如果在您的环境中无法直接使用 npm install,比如需要走代理、使用自建的 npm 源站、本地调试云函数、使用其他包管理器如 yarn 等的情况,则不能使用工具的自动安装依赖,需手工执行相应依赖安装命令。

云函数的运行环境是 Node.js,因此我们可以使用 npm 安装第三方依赖。您只能对每个云函数分别安装依赖。具体操作如下:

  1. 在云函数的根目录下,单击右键需要安装依赖的云函数,单击 【在终端中打开】。
  2. 在弹出的 cmd 窗口中输入指令,安装所需依赖。如 wx-server-sdk (opens new window) 依赖或 tcb-admin-node (opens new window) 依赖。示例代码如下:
npm install --save wx-server-sdk
npm install --save tcb-admin-node

TIP

  • wx-server-sdk 是基于 tcb-admin-node开发的服务端 SDK,与小程序端的接口使用方式一致,能获得更一体的开发体验。但如果想获得更高级的功能,可使用 tcb-admin-node
  • 需要特别注意的是,在 wx-server-sdk 依赖中不再兼容 successfailcomplete 回调,总是只会返回 Promise
  • 如果在执行安装命令后出现类似错误提示:rollbackFailedOptional: verb npm-session ****************,这是由于npm官方库是国外的网站,在访问时可能由于网络原因导致异常。

除了使用 Node.js 提供的原生 HTTP 接口在云函数中发起网络请求,我们还可以使用常用的网络请求库 request (opens new window) 来更便捷的发起网络请求。要为云函数安装 request 模块,您需要进入您的云函数目录,运行以下代码:

npm install request

TIP

在为运行环境为 Node.js 的云函数安装依赖时,如果是扩展型的 npm 包,要选择运行环境对应的 Node.js 版本并在 Linux 环境下安装。