微信开发者工具云函数右键菜单「上传并部署」消失的排查与解决

问题现象

在微信开发者工具中，为项目添加了云函数目录后，右键该目录，弹出菜单中未出现「上传并部署」选项。同时，云开发控制台中也没有相应的上传入口，导致无法将本地云函数部署至云端。

问题根因

经排查，问题出在项目根目录下的 project.config.json 配置文件。配置文件中的云函数目录字段配置有误，导致开发者工具未能正确识别云函数目录。

project.config.json 中存在两个功能相近但用途不同的字段：

• cloudfunctionRoot：经典云函数的目录配置字段，兼容性最佳，工具对该字段的识别成熟稳定
• cloudbaseRoot：新版云开发的目录配置字段，适用于云函数与云托管混合场景，需要特定的目录结构支持

若使用 cloudbaseRoot 配置云函数目录，而实际项目仅包含经典云函数，则开发者工具无法将对应目录识别为云函数目录，表现为目录图标为普通文件夹而非云函数特有的云朵图标，右键菜单中自然也不会出现「上传并部署」选项。

解决方案

修改 project.config.json，将云函数目录字段更正为 cloudfunctionRoot，并将 compileType 调整为 miniprogram：

{
  "compileType": "miniprogram",
  "cloudfunctionRoot": "cloudfunctions/",
  "libVersion": "3.16.1",
  "appid": "你的AppID"
}

注意：cloudfunctionRoot 与 cloudbaseRoot 两个字段不可同时配置，应根据实际项目类型选择其一。仅使用经典云函数时，务必使用 cloudfunctionRoot。

修改配置后，需关闭项目后重新打开，开发者工具会重新解析目录结构，此时云函数目录的文件夹图标将从普通文件夹变为云朵 ☁️ 图标，右键菜单中将正常出现「创建并部署」选项。

云函数部署建议

右键云函数目录后，会出现两个部署选项：

对于大多数云函数场景，选择「云端安装依赖」即可满足需求，无需上传本地 node_modules 目录。

验证部署结果

部署成功后，可在云开发控制台「云函数」页面确认函数已上线。同时需确保小程序入口文件（app.js）中已正确初始化云开发能力：

App({
  onLaunch() {
    wx.cloud.init({
      env: '你的云开发环境ID',
      traceUser: true,
    });
  }
});

环境 ID 可在云开发控制台首页复制获取。

小结

本文所述问题的本质是 project.config.json 中云函数目录字段配置不当，导致开发者工具无法识别云函数目录，从而缺失上传部署入口。只需将 cloudbaseRoot 替换为 cloudfunctionRoot，重启项目后即可恢复正常。