官方示例代码：
 
wx.downloadFile({
  url: 'https://example.com/audio/123', //仅为示例，并非真实的资源
  success (res) {
    // 只要服务器有响应数据，就会把响应内容写入文件并进入 success 回调，业务需要自行判断是否下载到了想要的内容
    if (res.statusCode === 200) {
      wx.playVoice({
        filePath: res.tempFilePath
      })
    }
  }
})
 
下面是完整版代码（ps：添加是否授权开启相册）
 
let fileName = new Date().valueOf();
wx.downloadFile({
	url: url, //下载链接
	filePath: wx.env.USER_DATA_PATH + '/' + fileName + '.mp4',
	success: res => {
		console.log(res)
		let filePath = res.filePath;
		wx.saveVideoToPhotosAlbum({
			filePath,
			success: file => {
				wx.showToast({title: '下载成功',icon: 'success',duration: 2000})
			},
			fail: err => {
				this.loading =  false
				if (err.errMsg === 'saveVideoToPhotosAlbum:fail auth deny') {
					wx.showModal({
						title: '提示',
						content: '需要您授权保存相册',
						showCancel: false,
						success: data => {
							wx.openSetting({
								success(settingdata) {
									if (settingdata.authSetting['scope.writePhotosAlbum']) {
										wx.showModal({
											title: '提示',
											content: '获取权限成功,再次点击下载即可保存',
											showCancel: false,
										})
									} else {
										wx.showModal({
											title: '提示',
											content: '获取权限失败，将无法保存到相册哦~',
											showCancel: false,
										})
									}
								},
							})
						}
					})
				}
			}
		})
	},
	fail:res=>{
		this.loading =  false
		console.log(res)
	}
})
 
当然，这并还没有结束
 当你下载多的时候，可能会报出saveFile:fail the maximum size of the file storage limi或者uploadFile:fail exceed max upload connection count 10错误
 原因是微信的使用限制
 
 对于以上错误，可用FileSystemManager.readdir及FileSystemManager.unlink去处理
 代码如下，具体参数及回调可以查看官方文档
 
//读取目录内文件列表
wx.getFileSystemManager().readdir({
	dirPath: wx.env.USER_DATA_PATH,
	success(res){
		console.log(res)
	},
	fail(res){
		console.log(res)
	}
})
//删除文件
wx.getFileSystemManager().unlink({
	filePath: wx.env.USER_DATA_PATH + '/' + fileName + '.mp4',
	success(res){
		console.log(res)
	},
	fail(res){
		console.log(res)
	}
})

wx.downloadFile遇到损坏的图片，下载失败
 
说明
 小程序获取用户微信头像过程中图片损坏，在使用wx.downloadFile下载图片的时候加上失败的回调，可以在失败回调里面setData一个默认的图片，当下载图片失败时用默认图片
 
注意
 下载图片失败时，log里面可能会随机报一个undefined的错误，我遇到的就是下面这个
 
 
wx.downloadFile({
          url: that.data.httpsUrl + res.data.data.avatar,
          success: function(res) {
            // 下载图片成功，临时路径为res.tempFilePath
            console.log(
              'downloadFile 下载图片成功,path=' + res.tempFilePath
            );
            that.setData({
              avatar: res.tempFilePath
            });
          },
		  // 加上失败的回调
          fail: function(res) {
            // 用户头像损坏，头像下载失败，给默认头像
            console.log('头像失败', res)
            that.setData({
              avatar: '../../image/vclass/ren7@2x.png'
            });
          }
        });

 
 
 
<template>
  <view class="black">
    <image class="localimg" mode="widthFix" :src="localimg" @longpress="operator"></image>
  </view>
</template>
 
<script>
  export default {
    data() {
      return {
        localimg: ''
      };
    },
    // 其他页面传参
    onLoad() {
      this.localimg = 'https://bkimg.cdn.bcebos.com/pic/fc1f4134970a304e023b1783dcc8a786c9175ca9?x-bce-process=image/resize,m_lfit,w_500,h_500,limit_1';
    },
    methods: {
      operator() {
        // 1 选择保存图片到本地
        uni.showActionSheet({
          itemList: ["保存图片到本地"],
          success:(res)=> {
            if (res.tapIndex == 0) {
              // 2 提示保存中
              uni.showLoading({
                title: "图片保存中..."
              })

              // 3 下载到本地
              uni.downloadFile({
                url: this.localimg,
                success:(result)=> {
                  var tempFilePath = result.tempFilePath;
                  
                  // 4 保存到本地
                  uni.saveImageToPhotosAlbum({
                    filePath: tempFilePath,
                    success:()=> {
                      // 5 提示保存成功
                      uni.showToast({
                        title: "保存成功",
                        duration: 2000
                      })
                    },
                    fail:()=>{
                      //  6 失败关闭提示信息！！！
                      console.log("saveImageToPhotosAlbum 失败");
                      uni.hideLoading();
                    },
                    complete: function() {
				      // 7 隐藏提示
					  uni.hideLoading();
					}
                  })
                },
                fail:()=> {
                  console.log("downloadFile 失败");
                }
              })
            }
          },
          fail:()=> {
            console.log("showActionSheet 失败");
          }
        })
      }
    }
  }
</script>
 
<style scoped>
  .black {
    width: auto;
    height: 100%;
    padding:50rpx;
  }
</style>
 
 

uniapp开发微信小程序时，使用uni.downloadFile下载图片在苹果手机可以正常下载，安卓手机就会报报错unknown问题
 
解决办法：使用指定保存路径的办法，设置filePath，代码如下
 
uni.downloadFile({
 
    url: ctx + '/f/wx/getMiniProgramQrCode?page=pages/nearServer/nearServer&scene='+that.userInfo.bakId+'&width=300',
 
    header: {
 
     'content-type': 'application/png'
 
    },
 
    filePath: wx.env.USER_DATA_PATH + '/file.png',
 
    success: function success(res) {
 
        if (res.statusCode == 200) {
 
        }
 
    }
 
})