为go-units添加新单位：如何正确实现自定义单位转换？

问题分析 #

你当前的代码每次调用ValidVolumeUnits()都会创建一个新的Teaspoon单位实例，转换关系仅绑定到这个临时实例上。后续尝试用tsp符号做转换时，go-units库找不到对应的全局注册关系，因此报错。

正确实现方式 #

核心要保证自定义单位只初始化一次，且转换关系被全局注册，用全局变量+init函数就能解决：

package yourpackage

import "github.com/golang/go-units"

// 全局变量存储自定义单位，确保整个程序中只有一个实例
var (
    Teaspoon   *units.Unit
    Tablespoon *units.Unit
    // 可继续添加滴数、喷雾量等自定义单位
)

func init() {
    // 初始化茶匙单位并注册转换（1茶匙≈4.93毫升）
    Teaspoon = units.NewUnit("Teaspoon(s)", "tsp")
    if err := units.NewRatioConversion(Teaspoon, units.MilliLiter, 4.93); err != nil {
        panic("failed to register teaspoon conversion: " + err.Error())
    }

    // 示例：添加汤匙单位（1汤匙≈14.79毫升）
    Tablespoon = units.NewUnit("Tablespoon(s)", "tbsp")
    if err := units.NewRatioConversion(Tablespoon, units.MilliLiter, 14.79); err != nil {
        panic("failed to register tablespoon conversion: " + err.Error())
    }
}

func ValidVolumeUnits() []string {
    return []string{
        units.Liter.Symbol,
        units.MilliLiter.Symbol,
        units.Quart.Symbol,
        units.Pint.Symbol,
        units.Gallon.Symbol,
        units.FluidOunce.Symbol,
        Teaspoon.Symbol,
        Tablespoon.Symbol,
    }
}

关键要点说明 #

• 全局变量存单位实例：避免每次调用函数都新建对象，确保库内部的转换映射能关联到同一个实例。
• init函数执行初始化：init()会在包加载时自动执行一次，保证自定义单位和转换关系在业务代码使用前就完成注册。
• 检查注册错误：NewRatioConversion可能返回重复注册等错误，通过panic或日志提前发现问题。

扩展第三方库的通用方法 #

这类场景的通用规则：

• 不要在业务函数中重复创建扩展对象，改用全局变量存储唯一实例。
• 初始化/注册逻辑放在init()函数中，确保只执行一次。
• 严格遵循第三方库的扩展API规范，比如go-units要求转换关系必须绑定到全局注册的单位实例。
• 注册后验证结果，确保扩展逻辑生效。

内容的提问来源于stack exchange，提问作者Richard Haley