Go Humanize 怎样用 CommafWithDigits 控制千分位小数位

humanize.CommafWithDigits(value, decimals) 接收 float64，并返回带逗号千分位、最多保留指定小数位的字符串。当前实现先使用 Commaf 格式化，再截取小数部分：它不会四舍五入，也不会为了凑足位数自动补零。

官方地址：https://github.com/dustin/go-humanize

例如看板中的读数 12543.9876 只想显示两位，可以用该函数得到语义上的 12,543.98。如果要求的是四舍五入后的两位，或者每个单元格必须始终显示两位，就需要另一种格式策略。本文从数据与展示边界解释风险，不把普通格式化夸大成安全漏洞。

先明确要保护的是数值还是展示文本

这个函数解决的是可读性。原始数值用于计算、排序和接口传输，展示文本用于让人阅读。位数参数来自请求或界面配置时，应用还应决定允许的范围，避免展示不一致或把错误配置带到所有页面。

主要风险有三个：把截取误认为舍入，导致读数解释不一致；把格式化字符串重新用于计算，破坏类型边界；把非有限数或异常输入当成正常读数显示。它们应分别在展示规则、输入规则和数据模型上解决。

接口说明见 Humanize API，实现细节见 comma.go。本文围绕当前读取到的实现，不宣称所有历史或未来版本完全相同。

理解 decimals 是上限而不是固定宽度

表中是实现规则的示例推导，没有执行或伪造运行日志。对于 decimals

对应结构图包含 float64、Commaf、逗号分组文本、decimals、stripTrailingDigits、展示字符串：前者决定数值文本，位数参数约束后面的字符串截取。该辅助函数的行为见 ftoa.go。

为展示入口限制数值和位数

下面的完整程序把允许小数位限制为 0 到 6，拒绝 NaN 和无穷大。这是示例应用的输入策略，并不是 Humanize 对调用者强加的范围。项目需在 go.mod 中声明并固定 github.com/dustin/go-humanize 版本。

package main

import (
    "fmt"
    "log"
    "math"

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

type Reading struct {
    Value float64
    Text  string
}

func presentReading(value float64, digits int) (Reading, error) {
    // 展示规则由应用决定，不把负数参数静默当作特殊格式。
    if digits  6 {
        return Reading{}, fmt.Errorf("小数位必须在0到6之间")
    }
    // 无效读数进入错误分支，不作为普通数值显示。
    if math.IsNaN(value) || math.IsInf(value, 0) {
        return Reading{}, fmt.Errorf("读数必须是有限数")
    }
    return Reading{
        Value: value, // 保留原始数据，计算和排序仍使用数值字段。
        Text:  humanize.CommafWithDigits(value, digits),
    }, nil
}

func main() {
    values := []float64{12543.9876, 12543.5, 12543, -12543.9876}
    for _, value := range values {
        reading, err := presentReading(value, 2)
        if err != nil {
            log.Printf("无法展示读数: %v", err)
            continue
        }
        // 只把带分组符的字符串用于面向人的展示。
        fmt.Printf("原始值=%v 展示值=%s", reading.Value, reading.Text)
        fmt.Println()
    }
}

示例没有外部资源，不需要启动数据库、浏览器或服务，也没有附上本地执行结果。非有限数拒绝策略可以换成显示“暂无数据”，但应把这种占位状态与真实的零区分开。

没有必要为控制两位小数先把值乘以一百再转 int；那会引入额外的范围、溢出和负数处理问题。先确定展示要求，再用相应格式接口，代码更容易理解。

把格式化结果留在展示层

第二张图的节点是 原始数值、计算排序、展示函数、输入策略、展示文本、页面输出。计算排序依赖原始数值，展示函数同时依赖数值与输入策略，展示文本归属于页面输出。

把字符串 12,543.98 当作机器数值传给普通解析器，可能因逗号而失败；按字符串排序还可能得到与数值排序不同的结果。接口最好分别定义原始数值字段和显示字段，而不是让所有接收端猜测如何去逗号。

如果在 HTML 中展示，仍使用框架正常的文本输出或转义机制。数字格式化不能替代整体模板的输出规则。诊断记录可保留格式配置、输入是否有限、生成的是哪一种展示策略；没有必要为了排查显示问题记录整批敏感业务数据。

需要四舍五入或补零时怎么选

若没有千分位要求，标准库的固定小数格式可以承担定宽展示；若同时需要分组和明确舍入，应选择能表达这两项要求的格式器，或在清楚的十进制数值策略下统一处理。不要在末尾机械补零之前就忽略前面已经发生的是截取。

这里接收的是 float64，不能恢复上游已丢失的十进制信息。要求精确十进制计算时，应从数据输入和数值类型开始设计，再在最后展示。地区格式也需要单独考虑：本函数的逗号分组和点号小数不是所有语言地区的通用格式。

为什么设置两位却只显示一位？

decimals 表示最多保留多少小数位，12543.5 不会因此变成 12,543.50。固定显示位数是另一项需求。

为什么第三位是 7，第二位没有进位？

当前实现截取已有字符串，不执行四舍五入。若读者预期进位，应更换或明确增加舍入策略，而不是把参数再调大后当作问题已解决。

格式化会修改原来的 float64 吗？

函数返回新的字符串，示例仍保留 Value 字段。是否把原值覆盖成文本由应用决定，推荐把两种字段分开。