如何安全地打印 Go 中指针的值（nil 安全的日志输出方案）-Golang-PHP中文网

如何安全地打印 Go 中指针的值（nil 安全的日志输出方案）

在 Go 中，直接解引用 nil 指针会引发 panic；本文介绍一种简洁、通用且无需显式 if/else 判断的 nil 安全日志方案——利用 json.Marshal 自动处理 nil 指针，并支持单个变量、多值组合及嵌套结构体的统一打印。

在 go 中，直接解引用 nil 指针会引发 panic；本文介绍一种简洁、通用且无需显式 if/else 判断的 nil 安全日志方案——利用 `json.marshal` 自动处理 nil 指针，并支持单个变量、多值组合及嵌套结构体的统一打印。

Go 语言中，对 nil 指针执行 *ptr 操作会导致运行时 panic，因此在日志输出前必须进行 nil 检查。虽然可借助 if ptr != nil { fmt.Println(*ptr) } else { fmt.Println("nil") } 实现，但重复编写此类逻辑既冗余又易出错。更优雅的替代方案是利用 Go 标准库的 encoding/json：json.Marshal 对 nil 指针自动序列化为 null，对非 nil 指针则递归序列化其指向的值，整个过程安全、无 panic，且天然支持任意嵌套结构。

以下是一个实用的封装函数示例：

import (
    "encoding/json"
    "log"
)

func printJSON(i ...interface{}) {
    if b, err := json.Marshal(i); err == nil {
        log.Println(string(b))
    } else {
        log.Printf("JSON marshal error: %v", err)
    }
}

配合结构体使用效果更佳：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

type Line struct {
    Point1 *string
    Point2 *string
    Name   string
}

func main() {
    p := "hi"
    point2 := &p
    line := Line{Point1: nil, Point2: point2, Name: "demo"}

    // 单个指针或混合类型（自动处理 nil）
    printJSON(line.Point1, line.Point2, line.Name)
    // 输出: [null,"hi","demo"]

    // 整个结构体（nil 字段转为 null，非 nil 正常展开）
    printJSON(line)
    // 输出: {"Point1":null,"Point2":"hi","Name":"demo"}
}

⚠️ 注意事项：