Go humanize 怎么给大整数增加千位分隔符

在账单汇总、库存计数或报表导出里，数字本身可能远远超过 int64，但读者仍希望看到清楚的千位分隔。Go 的 math/big.Int 负责保存任意精度整数，github.com/dustin/go-humanize 的 BigComma 负责把它变成十进制展示文本，例如把 12345678901234567890 显示为 12,345,678,901,234,567,890。

官方资料：https://pkg.go.dev/github.com/dustin/go-humanize

我实际会把这件事拆成两层：先把外部字符串解析为 big.Int，再在展示边界调用 humanize.BigComma。这样逗号只存在于输出，不会混进后续计算。

• 输入层：十进制字符串交给 big.Int.SetString，保留解析失败的分支。
• 数值层：用 big.Int 保存真实整数，不用展示字符串做加减。
• 展示层：用 BigComma 输出每三位一组的十进制文本。

BigComma 负责什么

BigComma 的职责很窄：接收一个 *big.Int，返回十进制字符串，并在每三个数量级之间插入逗号。它不是金额计算器，也不会把结果变成新的整数。负号仍然位于最左侧，零值会得到 0。

这一区分很重要：12,345 是给人看的字符串，不能直接拿去做数值运算。程序内部继续保留 big.Int，只有模板、日志、报表或接口展示层才调用格式化函数。

从字符串读取超大整数

如果数字来自 JSON、CSV、数据库或表单，先使用 SetString 读取十进制文本。它返回“是否成功”，而不是一个可以忽略的错误对象；空字符串、带逗号的展示文本和含有非数字字符的输入都应该由调用方决定如何拒绝。

package main

import (
	"fmt"
	"math/big"

	"github.com/dustin/go-humanize"
)

func formatLargeInteger(raw string) (string, error) {
	// 以 10 进制读取原始文本，避免先转 int64 造成溢出。
	n := new(big.Int)
	if _, ok := n.SetString(raw, 10); !ok {
		// 解析失败属于输入问题，不能把失败值继续交给展示层。
		return "", fmt.Errorf("无效的十进制整数: %q", raw)
	}

	// BigComma 只负责展示，n 仍然是可继续计算的任意精度整数。
	return humanize.BigComma(n), nil
}

func main() {
	// 这个值超过常见机器整数范围，仍可按十进制精确保存。
	text, err := formatLargeInteger("12345678901234567890")
	if err != nil {
		fmt.Println("读取失败:", err)
		return
	}

	// 输出层才出现千位分隔符，不把展示文本写回数值变量。
	fmt.Println(text) // 12,345,678,901,234,567,890
}

项目第一次引入依赖时，可以在模块目录执行下面的命令；命令只负责声明依赖，具体版本仍由项目的 go.mod 管理。

# 在 Go module 中加入人类可读数字格式化依赖
go get github.com/dustin/go-humanize

解析时不要先调用 strconv.ParseInt 再转成 big.Int，因为那样会先受限于 int64。如果上游已经传来 12,345 这样的展示文本，也不要直接当成纯十进制输入；应该先明确是否允许分隔符，再按业务规则清洗并记录来源。

正数、负数和零值都在同一展示规则里

BigComma 对符号的处理和数字分组是分开的：正数按三位分组，负号留在开头，全零整数返回 0。因此同一张报表可以复用一个格式化出口，不必为负数额外拼接逗号。

func examples() {
	// SetString 保留任意精度，第二个返回值用于区分非法文本。
	values := []string{"0", "-9876543210", "100000000000000000000"}
	for _, raw := range values {
		n := new(big.Int)
		if _, ok := n.SetString(raw, 10); !ok {
			// 生产代码可以把原始字段和错误一起交给上层记录。
			fmt.Println("跳过非法输入:", raw)
			continue
		}

		// 这里得到的都是展示字符串，不能再用于后续算术。
		fmt.Println(raw, "=>", humanize.BigComma(n))
	}
}

如果业务需要判断是否为零，应在 big.Int 上调用 Sign 或与零值比较；不要根据格式化后的字符串是否等于某个固定样式来猜测数值含义。

BigComma、BigCommaf 和计算边界

BigComma 面向 *big.Int；如果数据本身是任意精度小数，才考虑 BigCommaf 接收的 *big.Float。两者都属于“格式化出口”，不能替代精度策略。涉及金额时，先确定金额单位和舍入规则，再决定是整数分单位、定点数还是浮点数；不要因为输出好看就把业务精度交给字符串拼接。

常见问题

BigComma 能直接接收字符串吗？

不能。它接收的是 *big.Int；字符串应先经过 SetString，确认成功后再格式化。

为什么不先用 strconv.ParseInt？

因为 ParseInt 的目标类型有范围限制，超出 int64 的数字会在到达 big.Int 之前失败。对超大十进制文本，直接使用 SetString 更合适。

带逗号的数字可以继续相加吗？

不建议。逗号结果是展示文本；继续计算应保留 big.Int，计算完成后再调用 BigComma。

负数需要单独处理吗？

通常不需要。BigComma 会保留负号并按三位分组；业务是否允许负数，应该在数值层单独判断。

可以把这条规则记成一句话：用 big.Int 保存精确整数，用 SetString 处理外部十进制输入，用 humanize.BigComma 在最后一层增加千位分隔符。