Go Template中优雅处理循环最后一项：自定义函数实践

import (
    "reflect"
    "text/template"
)

// last 是一个自定义模板函数，用于判断给定索引 x 是否为集合 a 的最后一项。
// a 可以是任何可迭代的类型（切片、数组、map、字符串）。
func last(x int, a interface{}) bool {
    // 使用 reflect.ValueOf 获取 a 的反射值，然后获取其长度。
    // 减 1 是因为索引从 0 开始。
    return x == reflect.ValueOf(a).Len()-1
}

package main

import (
    "fmt"
    "os"
    "reflect"
    "text/template"
)

func main() {
    // 1. 定义自定义函数映射
    fns := template.FuncMap{
        "last": func(x int, a interface{}) bool {
            return x == reflect.ValueOf(a).Len()-1
        },
    }

    // 2. 解析模板，并注册自定义函数
    // 注意：在模板中，`$`符号通常指代当前的数据上下文。
    // 在range循环中，`$i`是当前索引，`$e`是当前元素，
    // 而`$`（没有点号）则代表整个被迭代的原始数据（即这里的`data`切片）。
    tmplStr := `{{range $i, $e := .}}` +
        `{{if $i}}, {{end}}` + // 除了第一个元素，其他前面都加逗号和空格
        `{{if last $i $}}and {{end}}` + // 如果是最后一项，则在其前面加 "and "
        `{{$e}}` +
        `{{end}}.` // 循环结束后加一个点号

    t := template.Must(template.New("listTemplate").Funcs(fns).Parse(tmplStr))

    // 3. 准备数据
    data := []string{"one", "two", "three"}

    // 4. 执行模板
    fmt.Println("--- 使用 reflect 包 ---")
    err := t.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
    fmt.Println() // 换行
}

--- 使用 reflect 包 ---
one, two, and three.

import (
    "text/template"
)

// lastTypeSpecific 是一个类型特定的自定义模板函数，
// 仅适用于 []string 类型的集合。
func lastTypeSpecific(x int, a []string) bool {
    return x == len(a)-1
}

package main

import (
    "fmt"
    "os"
    "text/template"
)

func main() {
    // 1. 定义自定义函数映射（类型特定）
    fns := template.FuncMap{
        "last": func(x int, a []string) bool { // 注意这里 'a' 的类型是 []string
            return x == len(a)-1
        },
    }

    // 2. 解析模板，并注册自定义函数
    tmplStr := `{{range $i, $e := .}}` +
        `{{if $i}}, {{end}}` +
        `{{if last $i $}}and {{end}}` + // 模板调用方式不变
        `{{$e}}` +
        `{{end}}.`

    t := template.Must(template.New("listTemplate").Funcs(fns).Parse(tmplStr))

    // 3. 准备数据
    data := []string{"one", "two", "three"}

    // 4. 执行模板
    fmt.Println("--- 使用内置 len 函数 ---")
    err := t.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
    fmt.Println() // 换行
}

--- 使用内置 len 函数 ---
one, two, and three.