在 ag grid 中，需通过自定义 valueformatter 函数，根据当前行的标识字段（如首列值）动态选择格式化方式：匹配 "percentage" 时返回百分比字符串，其余情况按带千分位的十进制数字处理。

在 ag grid 中，需通过自定义 valueformatter 函数，根据当前行的标识字段（如首列值）动态选择格式化方式：匹配 "percentage" 时返回百分比字符串，其余情况按带千分位的十进制数字处理。

AG Grid 的列定义（columnDefs）本身不支持“按行格式化”，但其 valueFormatter 函数提供了强大的上下文访问能力——它接收完整的 params 对象，其中 params.node 指向当前行节点，params.data 是整行原始数据，params.value 是当前单元格原始值。这意味着你可以轻松读取同行其他字段（例如第一列的类型标识），从而实现行级条件格式化。

以下是一个完整、可直接使用的示例：

const columnDefs = [
  {
    headerName: 'Metric',
    field: 'metric', // 如 'value' 或 'percentage'
    width: 120,
  },
  {
    headerName: 'Col 1',
    field: 'col1',
    valueFormatter: params => {
      const rowType = params.data?.metric;
      if (rowType === 'percentage') {
        return `${(params.value * 100).toFixed(1)}%`;
      } else {
        // 使用 Intl.NumberFormat 实现标准千分位 + 1 位小数
        return new Intl.NumberFormat('en-US', {
          minimumFractionDigits: 1,
          maximumFractionDigits: 1
        }).format(params.value);
      }
    }
  },
  {
    headerName: 'Col 2',
    field: 'col2',
    valueFormatter: params => {
      const rowType = params.data?.metric;
      if (rowType === 'percentage') {
        return `${(params.value * 100).toFixed(1)}%`;
      } else {
        return new Intl.NumberFormat('en-US', {
          minimumFractionDigits: 1,
          maximumFractionDigits: 1
        }).format(params.value);
      }
    }
  }
];

对应的数据结构应为：

const rowData = [
  { metric: 'value',      col1: 2345.6, col2: 3677.7 },
  { metric: 'percentage', col1: 0.138,  col2: 0.096  }
];

✅ 关键要点说明：

• 不需要为每列重复编写逻辑：可将 formatter 提取为独立函数（如 rowAwareFormatter），提升复用性；
• params.data?.metric 是判断行类型的可靠依据，确保你的数据中存在明确的行标识字段；
• 避免在 formatter 中执行复杂计算或异步操作，它应在毫秒级完成，否则影响滚动性能；
• 若需支持国际化（如德语千分位为点、小数为逗号），Intl.NumberFormat 会自动适配用户浏览器 locale，无需硬编码分隔符。

通过这一模式，你无需转置数据结构，即可灵活实现“同一列内不同行采用不同数值格式”的专业表格呈现效果。