前端基于XLSX实现数据导出到Excel表格，以及提示“文件已经被损坏，无法打开”的解决方法

文章目录

- - 一、vue实现导出excel
  - - 1、前端实现
    - - 1、安装xlsx依赖
      - 2、引入
      - 3、方法
      - 4、使用
      - 4.1、将一个二维数组转成sheet
        4.2、将一个对象数组转成sheet
        4.3、合并单元格
        4.4、一次导出多个sheet
      - 5、支持的文件格式
    - 2、后端实现
  - 二、导出文件损坏
  - - 1、前端请求导出接口，增加返回类型
    - 2、取消受保护的视图

一、vue实现导出excel

1、前端实现

xlsx是一个用于读取、解析和写入Excel文件的JavaScript库。它提供了一系列的API来处理Excel文件。使用该库，你可以将数据转换为Excel文件并下载到本地。这种方法适用于在前端直接生成Excel文件的场景。

更多介绍可参见官网

1、安装xlsx依赖

npm install xlsx --save

2、引入

import XLSX from 'xlsx'

3、方法

在这里插入图片描述

aoa_to_sheet: 这个工具类最强大也最实用了，将一个二维数组转成sheet，会自动处理number、string、boolean、date等类型数据；
table_to_sheet: 将一个table dom直接转成sheet，会自动识别colspan和rowspan并将其转成对应的单元格合并；
json_to_sheet: 将一个由对象组成的数组转成sheet。

4、使用

4.1、将一个二维数组转成sheet

<template>
    <div>
        <button @click="exportExcel">导出excel</button>
    </div>
</template>

<script>
import XLSX from 'xlsx'
export default {
    methods: {
        exportExcel() {
            // 准备要导出的数据（二维数组）
            const data = [
                ['姓名','年龄','性别','地址'],
                ['张三',18,'男','北京市'],
                ['李四',19,'女','上海市']
            ]
            // 创建sheet对象
            const ws = XLSX.utils.aoa_to_sheet(data)
            // 创建一个工作薄
            const wb = XLSX.utils.book_new()
            // 将sheet对象放入到工作薄
            XLSX.utils.book_append_sheet(wb,ws,'Sheet1')
            // 导出Excel文件  
            XLSX.writeFile(wb,'test.xlsx')
        }
    }
}
</script>

在这里插入图片描述

4.2、将一个对象数组转成sheet

exportExcel() {
    // 准备要导出的数据（对象数组）
    let sheetData = [
        { '姓名': '张三', '年龄': 18 ,'性别':'男','地址':'北京市'},
        { '姓名': '李四', '年龄': 19 ,'性别':'女','地址':'上海市'},
    ]
    // 创建sheet对象
    let sheet = XLSX.utils.json_to_sheet(sheetData)
    // 创建一个工作薄
    let wb = XLSX.utils.book_new()
    // 将sheet对象放入到工作薄
    XLSX.utils.book_append_sheet(wb, sheet, 'Sheet1')
    // 导出Excel文件  
    XLSX.writeFile(wb,'data.xlsx')
}

在这里插入图片描述

4.3、合并单元格

sheet['!merges'] = [
    {
        e: { c: 1, r: 0 }, // 合并结束位置 
        s: { c: 0, r: 0 } // 合并开始位置
    }
]

c:列位置 r:表示行位置，从0开始。
上面的代码表示合并第1行的第1列和第2列。

在这里插入图片描述

4.4、一次导出多个sheet

XLSX.utils.book_append_sheet(wb, sheet1, sheetName1)
XLSX.utils.book_append_sheet(wb, sheet2, sheetName2)
XLSX.utils.book_append_sheet(wb, sheet3, sheetName3)

5、支持的文件格式

在这里插入图片描述

2、后端实现

在这种方法中，前端发起一个请求到后端，后端生成Excel文件并返回给前端，前端再将文件下载到本地。可以使用axios库来发起请求，并使用Blob和a标签来下载文件。这种方法适用于需要在后端处理数据并生成Excel文件的场景。

后端返回blob流文件，前端接收并导出。

<template>
    <div>
        <button @click="exportExcel">导出excel</button>
    </div>
</template>

<script>
import axios from 'axios'
export default {
    methods: {
        exportToExcel() {
          this.$http.get('/api/exportExcel').then(res => {
            const blob = new Blob([res.data], {type: 'application/vnd.ms-excel'})
            const link = document.createElement('a')
            link.style.display = 'none'
            link.href = URL.createObjectURL(blob)
            link.download = 'test.xlsx'
            document.body.appendChild(link)
            link.click()
          });
        }
    }
}
</script>

二、导出文件损坏

前端开发中导出excel文件，文件可以正常下载，但是使用office或者wps
打开失败，提示“文件已损坏，无法打开”。

在这里插入图片描述

1、前端请求导出接口，增加返回类型

注意，excel流文件一定要在请求的时候加上响应类型字段，也就是：responseType: 'blob’或者，responseType: ‘arraybuffer’ ，否则下载出来的excel文件就会损坏，就会打不开。

axios发请求，给axios做了二次封装，在请求拦截器的地方添加。

// 引入axios
import axiosFile from "axios"
// 创建axios实例
const axiosExport = axiosFile.create()
// request拦截器
axiosExport.interceptors.request.use((req)=>{
    //添加响应类型
    req.responseType = "blob"
    return req
})