Go函数返回结构体如何带字段名及解决未导出字段访问报错

这是Go开发者刚接触包导出规则时很容易踩的坑，我来一步步帮你解决：

问题根源 #

Go语言的封装规则非常明确：只有首字母大写的标识符（包括结构体字段、函数、变量、接口等）才能被其他包访问（也就是“导出”）。你在arg.go里定义的FlagsStruct字段argTest2是小写开头，属于未导出的内部字段，所以在main包中尝试访问inputFlags.argTest2时会触发编译错误。

另外你提到打印整个结构体显示{test1 test2}，这也是因为未导出字段在打印时只会显示值，不会显示字段名——导出后的字段打印时会自动带上字段名。

解决方案：导出结构体字段 #

只需要把FlagsStruct的字段名改成首字母大写，就能在其他包正常访问了。如果需要保持字段名在JSON/输出里的小写格式，可以配合结构体标签来实现：

修改后的arg.go代码 #

package arg

// FlagsStruct 导出结构体，字段也全部导出
type FlagsStruct struct {
    ArgTest1 string `json:"argTest1"` // 标签指定JSON序列化时的字段名
    ArgTest2 string `json:"argTest2"`
}

// GetInitFlags 导出函数，返回导出的结构体
func GetInitFlags() FlagsStruct {
    return FlagsStruct{
        ArgTest1: "test1",
        ArgTest2: "test2",
    }
}

修改后的main.go代码 #

package main

import (
    "fmt"
    "your-module-path/arg" // 替换成实际的包路径
)

func main() {
    inputFlags := arg.GetInitFlags()
    
    // 现在可以正常访问导出的字段
    fmt.Println("ArgTest2的值：", inputFlags.ArgTest2)
    
    // 打印带字段名的结构体（%+v格式化符会显示导出字段的名称）
    fmt.Printf("完整结构体：%+v\n", inputFlags)
    
    // 如果需要输出小写字段名的JSON，可以用encoding/json包
    // data, _ := json.Marshal(inputFlags)
    // fmt.Println("JSON格式：", string(data))
}

额外说明 #

1. 如果你的结构体和main函数在同一个包里，那小写字段也能正常访问，但跨包场景下必须遵守导出规则。
2. 结构体标签是可选的，如果你不需要JSON序列化等场景，直接写大写字段名即可。
3. Go的导出规则是语言层面的强制约束，目的是帮你实现包的封装，避免外部代码随意修改包内部的状态。

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