Golang模板多语言场景下printf变量填充报错求助

问题描述 #

在Golang模板中需要渲染多语言内容“you've finished part x of y”（x为循环索引，y为项目总长度），不能使用固定字符串硬编码。尝试通过以下代码实现：

{{with $translatedText := getTranslatedText "textID"}} {{printf $translatedText $index $totalLength}}{{end}}

其中$translatedText是包含两个%d占位符的翻译字符串，直接写死字符串时printf能正常填充参数，但使用变量传递格式串时，会抛出%!(EXTRA int=0, int=3)的参数过多错误，单独打印$index和$totalLength的值均正常。需要解决变量形式的翻译文本如何支持printf参数填充的问题。

解决方法 #

问题根源是Go模板的printf函数在处理变量格式串时，会将格式串本身额外计入参数列表，导致与占位符数量不匹配。以下两种方法可解决该问题：

方法一：封装带参数的翻译函数 #

将翻译与格式化逻辑合并到Go代码的自定义函数中，避免模板层拆分操作：

// Go代码中注册自定义函数
func getTranslatedTextWithArgs(textID string, args ...interface{}) string {
    // 原有的翻译逻辑，获取带占位符的模板字符串
    templateStr := fetchTranslation(textID)
    // 直接完成格式化
    return fmt.Sprintf(templateStr, args...)
}

// 模板中调用方式
{{getTranslatedTextWithArgs "textID" $index $totalLength}}

这种方式逻辑更集中，模板调用更简洁，也避免了模板层的参数传递问题。

方法二：使用模板call函数调用fmt.Sprintf #

如果不想修改现有翻译函数，可将fmt.Sprintf注册到模板全局变量中，通过call函数直接传递格式串和参数：

// Go代码初始化模板时注册Sprintf函数
tpl := template.Must(template.New("").Funcs(template.FuncMap{
    "Sprintf": fmt.Sprintf,
}).ParseFiles("your-template.tpl"))

// 模板中使用方式
{{with $translatedText := getTranslatedText "textID"}}
    {{call $.Sprintf $translatedText $index $totalLength}}
{{end}}

通过call函数可以正确传递所有参数给fmt.Sprintf，避免模板printf函数的参数计数问题。

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