vxe-table 高级教程：实现分组多列合计与自定义统计

在实际业务中，我们经常需要对表格数据进行分组，并对每组内的数值列进行统计，例如：按部门统计薪资总和、按角色统计任务数量、计算年龄平均值等。
vxe-table 提供了强大的聚合配置 aggregateConfig，配合列属性 aggFunc，可以轻松实现分组多列合计，并且支持为不同列定制不同的统计方式（求和、平均值、最大值等）。

本文将带你一步步实现一个按 role（角色）分组，并对 num 列求和、对 age 列求平均值的示例。

步骤

主要涉及两个配置：

配置项	类型	说明
aggregateConfig.groupFields	Array	指定按哪些字段进行分组，例如 ['role']
aggregateConfig.calcValuesMethod	Function	自定义统计逻辑，根据当前列和分组子行数据返回统计值
列配置中的 aggFunc	boolean	设置为 true 表示该列需要显示合计值

代码

在 calcValuesMethod 中，我们可以根据 column.field 来判断当前正在计算哪一列，然后对该分组下的所有子行（children）进行统计。

<template>
  <div>
    <vxe-grid v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'
const gridOptions = reactive({
  height: 500,
  showOverflow: true,
  aggregateConfig: {
    groupFields: ['role'],
    calcValuesMethod({ column, children }) {
      if (column.field === 'num') {
        let numSum = 0
        children.forEach((item) => {
          numSum += item.num
        })
        return numSum
      }
      if (column.field === 'age') {
        let ageCount = 0
        children.forEach((item) => {
          ageCount += item.age
        })
        return Math.floor(ageCount / children.length)
      }
      return 0
    }
  },
  columns: [
    { type: 'seq', width: 70 },
    { field: 'name', title: 'Name', minWidth: 300, rowGroupNode: true },
    { field: 'role', title: 'Role' },
    { field: 'num', title: 'Num', aggFunc: true },
    { field: 'age', title: 'Age', aggFunc: true },
    { field: 'address', title: 'Address' }
  ],
  data: [
    { id: 10001, name: 'Test1', role: 'Develop', sex: 'Woman', age: 28, num: 63, date: '2025-02-01', address: 'test abc' },
    { id: 10002, name: 'Test2', role: 'Test', sex: 'Man', age: 22, num: 63, date: '2025-01-01', address: 'Guangzhou' },
    { id: 10003, name: 'Test3', role: 'PM', sex: 'Woman', age: 32, num: 10, date: '2025-05-01', address: 'Shanghai' },
    { id: 10004, name: 'Test4', role: 'Designer', sex: 'Man', age: 32, num: 24, date: '2025-01-01', address: 'test abc' },
    { id: 10005, name: 'Test5', role: 'Develop', sex: 'Man', age: 30, num: 98, date: '2025-01-01', address: 'Shanghai' },
    { id: 10006, name: 'Test6', role: 'Designer', sex: 'Man', age: 30, num: 46, date: '2025-03-01', address: 'test abc' },
    { id: 10007, name: 'Test7', role: 'Test', sex: 'Woman', age: 29, num: 35, date: '2025-05-01', address: 'test abc' },
    { id: 10008, name: 'Test8', role: 'PM', sex: 'Woman', age: 35, num: 84, date: '2025-11-01', address: 'test abc' },
    { id: 10009, name: 'Test9', role: 'Test', sex: 'Man', age: 21, num: 25, date: '2025-05-01', address: 'test abc' },
    { id: 10010, name: 'Test10', role: 'PM', sex: 'Woman', age: 28, num: 32, date: '2025-03-01', address: 'test abc' },
    { id: 10011, name: 'Test11', role: 'Test', sex: 'Woman', age: 29, num: 24, date: '2025-03-01', address: 'test abc' },
    { id: 10012, name: 'Test12', role: 'Develop', sex: 'Man', age: 37, num: 28, date: '2025-10-01', address: 'test abc' },
    { id: 10013, name: 'Test13', role: 'Test', sex: 'Woman', age: 24, num: 38, date: '2025-02-01', address: 'test abc' },
    { id: 10014, name: 'Test14', role: 'Develop', sex: 'Man', age: 34, num: 46, date: '2025-08-01', address: 'test abc' },
    { id: 10015, name: 'Test15', role: 'Designer', sex: 'Man', age: 21, num: 48, date: '2025-05-01', address: 'test abc' },
    { id: 10016, name: 'Test16', role: 'Designer', sex: 'Woman', age: 21, num: 59, date: '2025-10-01', address: 'test abc' },
    { id: 10017, name: 'Test17', role: 'Test', sex: 'Man', age: 31, num: 81, date: '2025-12-01', address: 'test abc' },
    { id: 10018, name: 'Test18', role: 'Develop', sex: 'Woman', age: 32, num: 75, date: '2025-10-01', address: 'test abc' },
    { id: 10019, name: 'Test19', role: 'Test', sex: 'Man', age: 37, num: 80, date: '2025-02-01', address: 'test abc' },
    { id: 10020, name: 'Test20', role: 'Develop', sex: 'Man', age: 41, num: 60, date: '2025-03-01', address: 'test abc' }
  ]
})
</script>

通过 aggregateConfig.groupFields + calcValuesMethod + 列属性 aggFunc，vxe-table 提供了灵活的分组合计方案。你可以为不同列定制完全不同的统计逻辑，满足各种复杂的报表需求

https://vxetable.cn