在 go 语言中，只有首字母大写的结构体及其字段才能被其他包访问；小写字段为包内私有，需改为大写名称并配合包名限定符调用。
在 go 语言中，只有首字母大写的结构体及其字段才能被其他包访问；小写字段为包内私有，需改为大写名称并配合包名限定符调用。
Go 的可见性规则（exported vs unexported）是其类型系统的核心设计之一，直接决定了结构体能否被外部包使用。你定义的 Credentials 和 WwogcParams 结构体本身可以导出（即首字母大写），但若其字段全部为小写（如 key、name），这些字段在包外将不可访问——即使结构体类型能被导入，也无法读写或初始化其字段。
✅ 正确做法：结构体名与所有导出字段均须首字母大写
假设你的包名为 wwogc（推荐使用有意义的小写包名），应这样定义：
// 文件：wwogc/params.go
package wwogc
type Credentials struct {
Key string // ✅ 导出字段
ResponseType string // ✅ 导出字段
Subscription string // ✅ 导出字段
Locale string // ✅ 导出字段
}
type WwogcParams struct {
Name string // ✅ 导出字段
Value string // ✅ 导出字段
}
在 main.go 中使用时，必须通过包名显式限定类型，并使用字段名初始化（支持键值语法，更安全可读）：
// 文件：main.go
package main
import (
"fmt"
"your-module-path/wwogc" // 替换为实际模块路径，如 "github.com/you/project/wwogc"
)
func main() {
param1 := wwogc.WwogcParams{ // ✅ 使用包名 + 类型名
Name: "q",
Value: "Delhi",
}
wwogcParams := []wwogc.WwogcParams{param1}
credentials := wwogc.Credentials{
Key: "keykeykle",
ResponseType: "json",
Subscription: "premium",
Locale: "EN",
}
fmt.Printf("Params: %+v\n", wwogcParams)
fmt.Printf("Creds: %+v\n", credentials)
}
⚠️ 注意事项：
- 不可省略包名前缀：Go 不支持跨包类型裸名引用（如 WwogcParams{}），必须写成 wwogc.WwogcParams{}；
- 字段大小写即可见性：key 是私有字段，Key 才是导出字段；混淆会导致编译错误 cannot refer to unexported field；
- 推荐使用命名字段初始化：避免依赖字段顺序（如 {"q","Delhi"} 易错），增强可维护性；
- 若需提供构造函数（如 NewCredentials(...)），可进一步封装校验逻辑，提升 API 友好度。
总结：Go 的导出机制简单而严格——以大写字母开头即“公开”，否则“私有”。掌握这一规则，是编写可复用、符合 Go 惯例的包的基础前提。
