5行代码实现微信小程序图片上传与腾讯免费5G存储空间的使用

最新推荐文章于 2025-09-27 01:17:44 发布

原创最新推荐文章于 2025-09-27 01:17:44 发布 · 262 阅读

0 ·

CC 4.0 BY-SA版权

本文介绍微信小程序中使用腾讯云开发功能实现图片快速上传与存储的方法，仅需几行代码即可完成，大大提高开发效率。文章包含代码实现细节及视频教程指引。

本文介绍了如何在微信小程序开发中使用腾讯官方提供的云开发功能快速实现图片的上传与存储，以及介绍云开发的 5G 存储空间的基本使用方法，这将大大提高微信小程序的开发效率，同时也是微信小程序系列教程的视频版更新的文字版本摘要。

此文为「60 节实战课微信小程序开发视频教程」的第 51 小节内容，如果需要查看视频版本的实战操作，请直接跳至文章的最后部分查看。

1.云开发图片空间简介

在之前的文章微信小程序开发平台新功能「云开发」快速上手体验中我们简要介绍了腾讯官方给所有的微信小程序开发提供的云开发的主要功能点，主要包含了下面几个大的功能。

目前提供三大基础能力支持：
云函数：在云端运行的代码，微信私有协议天然鉴权，开发者只需编写自身业务逻辑代码
数据库：一个既可在小程序前端操作，也能在云函数中读写的 JSON 数据库
文件存储：在小程序前端直接上传/下载云端文件，在云开发控制台可视化管理

对于一般的图片上传功能开发，我们一般需要实现如下几个技术点：

后台服务器的购买；
API 域名的购买与配置；
API 功能的开发；
图片空间的逻辑处理以及合理管理；
配置图片 CDN 加速图片加载效率。

而当我们使用腾讯提供的云开发功能时，只需要几行代码即可在微信小程序里实现完整的图片上传逻辑，非常地方便、高效。

2.图片上传的代码实现

使用腾讯云开发实现图片上传的主要业务逻辑如下：

通过 wx.chooseImage 方法让用户选择设备中的图片资源；
通过 wx.cloud.uploadFile 方法实现图片的上传，上传至腾讯提供的免费 5G 空间中；
通过 wx.cloud.uploadFile 的回调事件处理云端返回的图片资源 ID、链接等相关属性，进行后续地处理。

下面我们直接看这三个业务逻辑的代码部分。

/* 图片的选择与上传部分逻辑 */
 // 上传图片
  doUpload: function () {
    // 选择图片
    wx.chooseImage({
      count: 1,
      sizeType: ['compressed'],
      sourceType: ['album', 'camera'],
      success: function (res) {

        wx.showLoading({
          title: '上传中',
        })

        const filePath = res.tempFilePaths[0]
        
        // 上传图片
        // 这部分可以自行处理图片的命名方式，这里图片进行了固定命名为 my-image
        const cloudPath = 'my-image' + filePath.match(/\.[^.]+?$/)[0]
        wx.cloud.uploadFile({
          cloudPath,
          filePath,
          success: res => {
            console.log('[上传文件] 成功：', res)

            app.globalData.fileID = res.fileID
            app.globalData.cloudPath = cloudPath
            app.globalData.imagePath = filePath
            
            // 上传成功后，页面进行跳转，在详情页加载图片显示等操作
            wx.navigateTo({
              url: '../storageConsole/storageConsole'
            })
          },
          fail: e => {
            console.error('[上传文件] 失败：', e)
            wx.showToast({
              icon: 'none',
              title: '上传失败',
            })
          },
          complete: () => {
            wx.hideLoading()
          }
        })

      },
      fail: e => {
        console.error(e)
      }
    })
  },

/* 这部分比较简单，直接在页面读取加载到的图片链接即可 */
  onLoad: function (options) {

    const {
      fileID,
      cloudPath,
      imagePath,
    } = app.globalData

    this.setData({
      fileID,
      cloudPath,
      imagePath,
    })
  },

图片在云开发管理器中的管理与查看，可以看到图片已成功上传。