Go text/template 中对空接口与非空接口字段访问的机制解析

package main

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

// Foo 是一个空接口
type Foo interface{}

// Bar 是一个非空接口，定义了一个方法
type Bar interface {
    ThisIsABar()
}

// Person 实现了 Foo 和 Bar 接口
type Person struct {
    Name string
}

func (p Person) ThisIsABar() {}

// FooContext 包含一个 Foo 类型的字段
type FooContext struct {
    Something Foo
}

// BarContext 包含一个 Bar 类型的字段
type BarContext struct {
    Something Bar
}

func main() {
    // 定义模板，尝试访问 .Something.Name
    tmpl := template.Must(template.New("test").Parse("姓名: {{ .Something.Name }}\n"))

    fmt.Println("--- 使用 FooContext (空接口) ---")
    // 1. 使用 FooContext，其中 Something 是空接口，可以访问底层 Person 的 Name 字段
    if err := tmpl.Execute(os.Stdout, FooContext{Person{"Timmy"}}); err != nil {
        fmt.Printf("Error: %s\n", err)
    }

    fmt.Println("\n--- 使用 BarContext (非空接口) ---")
    // 2. 使用 BarContext，其中 Something 是非空接口，直接访问 Name 字段会报错
    if err := tmpl.Execute(os.Stdout, BarContext{Person{"Timmy"}}); err != nil {
        fmt.Printf("Error: %s\n", err)
    }
}

--- 使用 FooContext (空接口) ---
姓名: Timmy

--- 使用 BarContext (非空接口) ---
Error: executing "test" at <.Something.Name>: can't evaluate field Name in type main.Bar

// 简化版，实际代码可能更复杂，但核心逻辑一致
// 摘自 Go 源码 pkg/text/template/exec.go#L323 (Go 1.22)
// 遍历管道中的命令，处理每个命令的值
for _, cmd := range pipe.Cmds {
    value = s.evalCommand(dot, cmd, value) // 上一个值作为当前命令的最终参数
    // 如果对象类型是 interface{}，则深入一层获取其内部具体值
    if value.Kind() == reflect.Interface && value.Type().NumMethod() == 0 {
        value = reflect.ValueOf(value.Interface()) // 漂亮！
    }
}

// 示例：直接传递具体类型
type MyContext struct {
    Data Person
}
// ...
tmpl.Execute(os.Stdout, MyContext{Person{"Timmy"}}) // 模板中 {{ .Data.Name }}

package main

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

// Foo 是一个空接口
type Foo interface{}

// Bar 是一个非空接口，定义了方法
type Bar interface {
    ThisIsABar()
    GetName() string // 新增方法，用于暴露姓名
}

// Person 实现了 Foo 和 Bar 接口
type Person struct {
    Name string
}

func (p Person) ThisIsABar() {}
func (p Person) GetName() string { // 实现 Bar 接口的 GetName 方法
    return p.Name
}

// FooContext 包含一个 Foo 类型的字段
type FooContext struct {
    Something Foo
}

// BarContext 包含一个 Bar 类型的字段
type BarContext struct {
    Something Bar
}

func main() {
    // 定义模板，尝试访问 Name 字段 (会报错)
    tmpl := template.Must(template.New("test").Parse("姓名: {{ .Something.Name }}\n"))
    // 定义另一个模板，通过 GetName 方法访问姓名 (推荐)
    tmplWithMethod := template.Must(template.New("testWithMethod").Parse("姓名 (通过方法): {{ .Something.GetName }}\n"))


    fmt.Println("--- 使用 FooContext (空接口) ---")
    if err := tmpl.Execute(os.Stdout, FooContext{Person{"Timmy"}}); err != nil {
        fmt.Printf("Error: %s\n", err)
    }

    fmt.Println("\n--- 使用 BarContext (非空接口)，直接访问字段 (预期报错) ---")
    if err := tmpl.Execute(os.Stdout, BarContext{Person{"Timmy"}}); err != nil {
        fmt.Printf("Error: %s\n", err)
    }

    fmt.Println("\n--- 使用 BarContext (非空接口) 并通过接口方法访问 (推荐做法) ---")
    if err := tmplWithMethod.Execute(os.Stdout, BarContext{Person{"Timmy"}}); err != nil {
        fmt.Printf("Error: %s\n", err)
    }
}

--- 使用 FooContext (空接口) ---
姓名: Timmy

--- 使用 BarContext (非空接口)，直接访问字段 (预期报错) ---
Error: executing "test" at <.Something.Name>: can't evaluate field Name in type main.Bar

--- 使用 BarContext (非空接口) 并通过接口方法访问 (推荐做法) ---
姓名 (通过方法): Timmy