如何在 Go 中自定义结构体打印，完整显示指针所指向的值-Golang-PHP中文网

Go 默认的 %#v 格式化输出仅显示指针地址，无法自动解引用并展示其值；要实现如 Ptr:(*string)("some string") 这类可读性强的调试输出，需为结构体实现 fmt.Stringer 接口。

go 默认的 `%#v` 格式化输出仅显示指针地址，无法自动解引用并展示其值；要实现如 `ptr:(*string)("some string")` 这类可读性强的调试输出，需为结构体实现 `fmt.stringer` 接口。

在 Go 中，fmt.Printf("%#v", v) 会以 Go 语法格式输出值，对指针仅显示内存地址（如 (*string)(0x1040a120)），而非其指向的内容。若希望调试时直观看到结构体中所有字段——尤其是指针字段实际指向的值——必须主动控制输出逻辑。

最简洁、标准且符合 Go 惯用法的方案是：为结构体实现 fmt.Stringer 接口（即定义 String() string 方法）。该方法会在 fmt.Print 系列函数遇到该类型时自动调用，从而完全自定义输出格式。

以下是一个完整示例：

使用Go语言搭建家庭相册系统-相关课件

下载

package main

import (
    "fmt"
    "reflect"
)

type test struct {
    Str string
    Ptr *string
}

// String 实现 fmt.Stringer 接口
func (t test) String() string {
    ptrVal := "nil"
    if t.Ptr != nil {
        ptrVal = fmt.Sprintf(`(*string)("%s")`, *t.Ptr)
    } else {
        ptrVal = "(*string)(nil)"
    }
    return fmt.Sprintf("main.test{Str:%q, Ptr:%s}", t.Str, ptrVal)
}

func main() {
    s := "some string"
    p := &s

    t := test{
        Str: s,
        Ptr: p,
    }

    fmt.Println(t) // 自动调用 t.String()
    // 输出：main.test{Str:"some string", Ptr:(*string)("some string")}

    // 也可配合 %v 或 %s 使用（%#v 不会调用 Stringer）
    fmt.Printf("via %%v: %v\n", t)
}

✅ 关键说明：

String() 方法必须返回 string 类型，且接收者应为值类型（如 test）或指针类型（如 *test）；本例使用值接收者，适用于小型结构体。
fmt.Printf("%#v", t) 不会触发 String() 方法——%#v 始终走默认反射格式化；应改用 %v、%s 或直接 fmt.Println(t)。
对于复杂嵌套结构或大量字段，可借助 reflect 包动态遍历字段（注意性能与可读性权衡），但简单场景建议显式拼接，更可控、易维护、无反射开销。

⚠️ 注意事项：