如何在Apache Superset中本地化D3 SI数字后缀（俄语）

核心思路 #

Superset的数字格式化依赖@superset-ui/core中的D3格式化器，要替换SI后缀，需通过自定义数字格式化器并注册到全局注册表实现——直接修改node_modules文件无效，因为构建过程会忽略依赖包内的修改，必须通过源码扩展方式注入自定义逻辑。

正确实现步骤 #

1. 自定义俄语后缀的D3格式化器 #

在superset-frontend/src/setup/setupFormatters.ts中添加以下代码，通过D3的formatLocale定义俄语本地化规则：

import { getNumberFormatterRegistry } from '@superset-ui/core';
import { formatLocale } from 'd3-format';

// 配置俄语数字格式的本地化规则
const ruNumberLocale = formatLocale({
  decimal: ',',
  thousands: ' ',
  grouping: [3],
  suffixes: {
    thousands: ' тыс.',
    millions: ' млн',
    billions: ' млрд',
    trillions: ' трлн'
  }
});

// 创建带.2s格式的俄语短格式格式化器
const ruShortNumberFormatter = ruNumberLocale.format('.2s');

// 注册到全局格式化器注册表
getNumberFormatterRegistry().registerValue('RU_SHORT', ruShortNumberFormatter);

2. 覆盖默认.2s格式（可选） #

如果希望所有使用.2s的图表自动切换为俄语后缀，可直接覆盖默认格式化器：

// 在setupFormatters.ts中追加
getNumberFormatterRegistry().registerValue('.2s', ruShortNumberFormatter);

3. 构建并重启服务 #

执行前端构建：

cd superset-frontend
npm install
npm run build

重启Superset容器：

docker-compose -f docker-compose-non-dev.yml up -d --build

4. 在图表中应用 #

• 若注册了新格式RU_SHORT：编辑图表时，在数字格式选项中选择该格式
• 若覆盖了默认.2s：直接使用原.2s格式即可自动显示俄语后缀

常见问题排查 #

• 修改node_modules无效：npm run build会从原始依赖包编译，不会读取你修改后的node_modules文件，必须通过setupFormatters.ts注入自定义逻辑
• 报错Invalid format: RU_SHORT：需确保setupFormatters.ts中正确导入d3-format的formatLocale，且注册代码在Superset初始化阶段执行（该文件是官方指定的格式化器初始化钩子）

效果验证 #

配置完成后，数字将按以下格式显示：

• 5000 → 5 тыс.
• 20000000 → 20 млн
• 8300000000 → 8.3 млрд

内容的提问来源于stack exchange，提问作者Данил Басов