如何在结构体定义了 String() 方法时仍打印其全部字段值

秋丽君_4448

秋丽君_4448

2026-06-30

906人浏览

原创

如何在结构体定义了 String() 方法时仍打印其全部字段值

当 Go 结构体实现了 String() 方法时,%+v 会调用该方法而忽略字段细节;使用 %#v 动词可绕过 String(),直接输出带包路径的完整字段结构。

当 go 结构体实现了 `string()` 方法时,`%+v` 会调用该方法而忽略字段细节;使用 `%#v` 动词可绕过 `string()`,直接输出带包路径的完整字段结构。

在 Go 语言中,fmt 包的格式化动词行为遵循明确的优先级规则:只要类型实现了 fmt.Stringer 接口(即包含 String() string 方法),%v 和 %+v 就会自动调用该方法,而非展开结构体字段——这是设计使然,而非 bug。因此,若需调试或日志中查看结构体真实字段状态(尤其在 String() 返回摘要信息或脱敏内容时),必须显式选用不触发 Stringer 的动词。

推荐方案是使用 %#v 动词,它以 Go 语法风格输出值的“可复现字面量”形式,包含包名、字段名和当前值,且完全忽略 String() 方法:

package main

import "fmt"

type Car struct {
    Brand string
    Year  int
    Color string
}

func (c Car) String() string {
    return fmt.Sprintf("Car{Brand: %q}", c.Brand) // 仅返回简化信息
}

func main() {
    car := Car{Brand: "Tesla", Year: 2024, Color: "Red"}

    fmt.Printf("%%+v: %+v\n", car) // 输出:Car{Brand: "Tesla"}
    fmt.Printf("%%#v: %#v\n", car) // 输出:main.Car{Brand:"Tesla", Year:2024, Color:"Red"}
}

✅ 关键特性:

Go语言(Golang)1.26.0
Go语言(Golang)1.26.0

Go语言(Golang)1.26.0版本官方下载,版本号 1.26.0,适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载
  • %#v 不调用 String(),始终展示底层结构;
  • 字段按定义顺序输出,含导出/未导出字段(对未导出字段显示实际值,前提是当前包内可访问);
  • 输出格式符合 Go 语法,可直接用于代码重构或测试断言。

⚠️ 注意事项:

  • %#v 会包含包路径(如 main.Car),若需跨包复用或简化输出,可结合 reflect 自定义打印逻辑,但通常 %#v 已满足绝大多数调试场景;
  • 避免在生产日志中无节制使用 %#v,因其可能暴露敏感字段或产生冗长输出;建议仅用于开发期诊断;
  • 若结构体嵌套较深或含循环引用,%#v 仍可能 panic,此时应配合 golang.org/x/exp/pretty 等安全打印库。

总之,%#v 是 Go 中绕过 Stringer 并获取结构体原始字段视图的标准、轻量且可靠的方式——无需修改原有类型,也无需引入反射开销。

相关文章

全能打印神器
全能打印神器

全能打印神器是一款非常好用的打印软件,可以在电脑、手机、平板电脑等设备上使用。支持无线打印和云打印,操作非常简单,使用起来也非常方便,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

go语言

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

4154

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

4291

25

Go中Type关键字的用法
Go中Type关键字的用法

Go中Type关键字的用法有定义新的类型别名或者创建新的结构体类型。本专题为大家提供Go相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.06

2429

5

go怎么实现链表
go怎么实现链表

go通过定义一个节点结构体、定义一个链表结构体、定义一些方法来操作链表、实现一个方法来删除链表中的一个节点和实现一个方法来打印链表中的所有节点的方法实现链表。

2023.09.25

4807

6

go语言编程软件有哪些
go语言编程软件有哪些

go语言编程软件有Go编译器、Go开发环境、Go包管理器、Go测试框架、Go文档生成器、Go代码质量工具和Go性能分析工具等。本专题为大家提供go语言相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.13

642

5

0基础如何学go语言
0基础如何学go语言

0基础学习Go语言需要分阶段进行,从基础知识到实践项目,逐步深入。php中文网给大家带来了go语言相关的教程以及文章,欢迎大家前来学习。

2023.10.26

6565

20

Go语言实现运算符重载有哪些方法
Go语言实现运算符重载有哪些方法

Go语言不支持运算符重载,但可以通过一些方法来模拟运算符重载的效果。使用函数重载来模拟运算符重载,可以为不同的类型定义不同的函数,以实现类似运算符重载的效果,通过函数重载,可以为不同的类型实现不同的操作。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2256

5

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2504

5

go语言开发工具大全
go语言开发工具大全

本专题整合了go语言开发工具大全,想了解更多相关详细内容,请阅读下面的文章。

2025.06.11

5479

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程