decimal

阅读提示

• 适用版本：Go 1.21+（示例在 Go 1.22 下验证）· 前置知识：语法基础-数据类型 · 阅读时长：约 10 分钟

仓库：shopspring/decimal: Arbitrary-precision fixed-point decimal numbers in go (github.com)

文档：decimal package - github.com/shopspring/decimal - Go Packages

简介

一个用 GO 编写的十进制浮点数工具库，具有以下特点：

• 零值为 0，不需要初始化即可安全使用
• 加法，减法，乘法，不会损失精度
• 以指定的精度除法
• 数据库/sql 序列化/反序列化
• JSON 和 XML 序列化/反序列化

安装

go get github.com/shopspring/decimal

快速开始

package main

import (
  "fmt"
  "github.com/shopspring/decimal"
)

func main() {
  price, err := decimal.NewFromString("136.02")
  if err != nil {
    panic(err)
  }

  quantity := decimal.NewFromInt(3)

  fee, _ := decimal.NewFromString(".035")
  taxRate, _ := decimal.NewFromString(".08875")

  subtotal := price.Mul(quantity)

  preTax := subtotal.Mul(fee.Add(decimal.NewFromFloat(1)))

  total := preTax.Mul(taxRate.Add(decimal.NewFromFloat(1)))

  fmt.Println("Subtotal:", subtotal)                      // Subtotal: 408.06
  fmt.Println("Pre-tax:", preTax)                         // Pre-tax: 422.3421
  fmt.Println("Taxes:", total.Sub(preTax))                // Taxes: 37.482861375
  fmt.Println("Total:", total)                            // Total: 459.824961375
  fmt.Println("Tax rate:", total.Sub(preTax).Div(preTax)) // Tax rate: 0.08875
}

完整示例

下面的程序可以直接运行：复制到文件后执行 go run main.go，或粘贴到 Go Playground 运行。

package main

import "fmt"

func main() {
	// 用"分"存储金额，避免二进制浮点误差
	price := int64(1999) // 19.99
	count := int64(3)
	total := price * count

	fmt.Printf("%d.%02d\n", total/100, total%100)

	// 对比 float64 的结果，说明为什么需要 decimal
	a, b := 0.1, 0.2
	fmt.Println(a + b)
}

预期输出：

59.97
0.30000000000000004

常见错误与踩坑

• float64 无法精确表示 0.1。 0.1 + 0.2 不等于 0.3；金额必须用整数或 decimal 类型。
• 舍入必须显式。 先确定精度（金额通常 2 位），再明确采用四舍五入还是银行家舍入。
• 除法要指定精度。 decimal.Div 的精度影响结果，设置不当会累积误差。
• JSON 不支持 decimal。 应序列化为字符串（或整数分），否则精度会丢失。
• 比较要用方法。 使用 Equal/Cmp，不要对包装类型用 ==。

更新记录

• 2026-10-14：新增"阅读提示"、完整可运行示例（含预期输出）、常见错误与踩坑清单，以及本更新记录。