Go语言中是否存在fmt格式限定符仅打印结构体非零值字段？

嘿，这个问题我之前也纠结过！很遗憾，Go标准库的fmt包没有内置的格式限定符能直接实现只输出结构体的非零值字段。不过别担心，我们可以通过两种实用方式来达成需求：

方法一：给结构体自定义String()方法 #

针对你的myStruct，我们可以手动实现String()接口，在方法里逐个判断字段是否为零值，只保留非零的部分拼接成字符串：

package main

import (
	"fmt"
	"strings"
)

type myStruct struct {
	a string
	b int
	c bool
}

// 实现String()方法，自定义输出格式
func (s myStruct) String() string {
	var fieldParts []string
	// 检查每个字段是否非零
	if s.a != "" {
		fieldParts = append(fieldParts, fmt.Sprintf("a:%q", s.a))
	}
	if s.b != 0 {
		fieldParts = append(fieldParts, fmt.Sprintf("b:%d", s.b))
	}
	if s.c { // bool的零值是false，直接判断即可
		fieldParts = append(fieldParts, fmt.Sprintf("c:%t", s.c))
	}
	return fmt.Sprintf("{%s}", strings.Join(fieldParts, " "))
}

func main() {
	s := myStruct{c: true}
	fmt.Println(s) // 输出 {c:true}
}

这种方式的好处是简单直接，性能也不错，但缺点是每个需要特殊输出的结构体都得单独写这个方法，复用性一般。

方法二：用反射写通用工具函数 #

如果需要处理多个不同的结构体，不想重复写代码，那就可以用Go的reflect包做一个通用函数，自动遍历结构体字段并筛选非零值：

package main

import (
	"fmt"
	"reflect"
	"strings"
)

type myStruct struct {
	a string
	b int
	c bool
}

// 通用函数：输出结构体的所有非零值字段
func FormatNonZeroStruct(v interface{}) string {
	val := reflect.ValueOf(v)
	// 处理传入指针的情况
	if val.Kind() == reflect.Ptr {
		val = val.Elem()
	}
	// 如果不是结构体，直接返回默认格式
	if val.Kind() != reflect.Struct {
		return fmt.Sprintf("%v", v)
	}

	var fieldParts []string
	structType := val.Type()
	for i := 0; i < val.NumField(); i++ {
		field := val.Field(i)
		fieldName := structType.Field(i).Name
		// 对比字段值和对应类型的零值
		zeroVal := reflect.Zero(field.Type()).Interface()
		if !reflect.DeepEqual(field.Interface(), zeroVal) {
			fieldParts = append(fieldParts, fmt.Sprintf("%s:%v", fieldName, field.Interface()))
		}
	}
	return fmt.Sprintf("{%s}", strings.Join(fieldParts, " "))
}

func main() {
	s := myStruct{c: true}
	fmt.Println(FormatNonZeroStruct(s)) // 输出 {c:true}

	// 测试另一个结构体
	type User struct {
		Name  string
		Age   int
		IsVIP bool
	}
	user := User{Name: "Bob", IsVIP: true}
	fmt.Println(FormatNonZeroStruct(user)) // 输出 {Name:Bob IsVIP:true}
}

这个方法的优势是通用性拉满，不管什么结构体都能直接用，不过反射会有一点点性能损耗，如果是对性能要求极高的场景，还是优先用第一种方法。

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