在go中，结构体字段若以小写字母开头则为包私有（不可导出），无法在其他包中通过结构体字面量直接初始化；必须将字段名首字母大写才能被外部包访问。
在go中，结构体字段若以小写字母开头则为包私有（不可导出），无法在其他包中通过结构体字面量直接初始化；必须将字段名首字母大写才能被外部包访问。
Go 语言通过标识符首字母的大小写严格控制作用域和可见性：以大写字母（Unicode 大写）开头的标识符（如字段、函数、类型、变量）是导出的（exported），可在其他包中访问；以小写字母开头的则是未导出的（unexported），仅限于定义它的包内使用。
你遇到的错误：
./cli.go:29: unknown yelk.PhoneOptions field 'phone' in struct literal
根本原因在于 yelk 包中 PhoneOptions 的字段全部为小写：
type PhoneOptions struct {
phone string // ❌ 未导出字段，外部包不可见
cc string // ❌ 同上
lang string // ❌ 同上
}当 cli.go（假设位于 main 包）尝试通过 yelk.PhoneOptions{phone: number} 初始化时，Go 编译器无法识别 phone 字段——因为它对 main 包不可见，等价于“不存在”。
立即学习“go语言免费学习笔记（深入）”；
✅ 正确做法是将字段名首字母大写，使其导出：
// yelk/phone_options.go
package yelk
type PhoneOptions struct {
Phone string // ✅ 导出字段，外部可访问
Cc string // ✅
Lang string // ✅
}随后在 cli.go 中即可正常初始化：
// cli.go
package main
import (
"os"
"your-module/yelk" // 替换为实际模块路径
)
func main() {
if len(os.Args) < 2 {
panic("missing phone number")
}
number := os.Args[1]
phoneOptions := yelk.PhoneOptions{Phone: number} // ✅ 编译通过
// 可选：设置其他字段
// phoneOptions := yelk.PhoneOptions{Phone: number, Cc: "1", Lang: "en"}
}⚠️ 注意事项：
- 字段名大写不仅影响结构体字面量初始化，也影响 JSON 序列化（json tag 可覆盖，但默认仍依赖导出性）、反射访问及方法接收者可见性；
- 若需保留内部实现细节（如不想暴露字段），应避免在外部包直接初始化结构体，转而提供导出的构造函数（如 NewPhoneOptions(phone string) PhoneOptions），并在函数内安全赋值未导出字段；
- Go 没有“public/private”关键字，可见性完全由命名约定决定——这是语言设计的核心原则之一，务必牢记。
总结：导出即大写，未导出即小写。这是 Go 包封装与 API 设计的基础规范，也是解决 unknown field in struct literal 类错误的唯一正确路径。
