feat: 添加数字格式化工具，支持去掉小数末尾多余的 0 和四舍五入功能

yuan

2 天以前 9f3bc47b98cbc51df7cfcea94d4aa0c35f40cbc5

 src/utils/summarizeTable.js

@@ -1,8 +1,16 @@
import { trimZeros, roundHalfUp } from "./formatNumber.js";

/**
 * 通用的表格合计方法
 * @param {Object} param - 包含表格列配置和数据源的对象
 * @param {Array<string>} summaryProps - 需要汇总的字段名数组
 * @param {Object} specialFormat - 特殊格式化规则：字段名 -> 格式化选项（如是否去掉小数）
 *   支持 { noDecimal: true }  取整显示
 *        { trimZeros: true, decimalPlaces: 6 }  最多保留 6 位小数并去掉末尾多余的 0
 *        { roundEach: 2 }  每行先按 2 位小数四舍五入再求和，
 *                          用于金额列：保证合计与列内展示值相加完全一致
 *        { formatter: fn }  自定义格式化函数，优先级最高
 *        { decimalPlaces: 2 }  固定保留 2 位小数（默认）
 * @returns {Array} 合计行数据
 */
const summarizeTable = (param, summaryProps, specialFormat = {}) => {
@@ -15,7 +23,15 @@
    }
    const prop = column.property;
    if (summaryProps.includes(prop)) {
      const values = data.map((item) => Number(item[prop]));
      const rule = specialFormat[prop];
      const values = data.map((item) => {
        const val = Number(item[prop]);
        // NaN 保持 NaN，便于下面判断「整列都不是数字」
        if (Number.isNaN(val)) return NaN;
        return rule && rule.roundEach != null
          ? roundHalfUp(val, rule.roundEach)
          : val;
      });
      // 只对有效数字进行求和
      if (!values.every(isNaN)) {
        const sum = values.reduce(
@@ -25,6 +41,15 @@
        if (specialFormat[prop] && specialFormat[prop].noDecimal) {
          // 如果指定了不需要保留小数，则直接转换为整数
          sums[index] = Math.round(sum).toString();
        } else if (
          specialFormat[prop] &&
          typeof specialFormat[prop].formatter === "function"
        ) {
          // 自定义格式化函数优先
          sums[index] = specialFormat[prop].formatter(sum);
        } else if (specialFormat[prop] && specialFormat[prop].trimZeros) {
          // 指定了去掉末尾多余的 0（最多保留 decimalPlaces 位，默认 6 位）
          sums[index] = trimZeros(sum, specialFormat[prop].decimalPlaces ?? 6);
        } else {
          // 默认保留两位小数
          sums[index] = parseFloat(sum).toFixed(