go包内标识符首字母大写才对外可见，作用于函数、变量、常量、类型、方法名和字段名；结构体字段或方法名小写则不可被外部访问，即使类型本身可导出。
Go 包内标识符什么时候算“对外可见”
Go 里没有 public / private 关键字，可见性只由**首字母大小写**决定：首字母大写（如 MyFunc、Config、ErrTimeout）才可被其他包导入访问；小写（如 helper、parseJSON、defaultVal）仅限本包内使用。
注意：这个规则作用于所有顶层声明——函数、变量、常量、类型、方法名、字段名。不是“包级可见”，而是“导出（exported）即可见”。
- 结构体字段小写 → 外部无法直接读写，哪怕结构体本身是大写的（
type User struct { name string }中name不可被外部访问） - 方法名小写 → 即使接收者类型可导出，该方法也无法被外部调用（
func (u *User) validate() bool不会被导出） - 嵌套结构体字段的可见性独立判断：外层大写、内层小写字段仍不可见（
type Resp struct { Data struct{ ID int } }→Resp.Data.ID无法访问）
跨包调用时 import 路径和包名不一致怎么办
Go 模块中，import 路径（如 "github.com/user/proj/pkg/util"）决定代码来源，而包名（util）只是本地引用别名，二者可以不同，但必须遵守一个硬约束：同一目录下所有 .go 文件的 package 声明必须完全一致。
常见错误：import "github.com/user/proj/internal/log" 后试图用 log.Debug(...)，却发现 log 是未定义的——实际该包声明的是 package logger，所以得写 logger.Debug(...)。
- 可通过
go list -f '{{.Name}}' github.com/user/proj/internal/log查看真实包名 - 允许用点号或别名简化调用：
import log "github.com/user/proj/internal/log"或import . "github.com/user/proj/internal/log"（后者慎用，易冲突） - 模块根路径（
go.mod第一行）不影响包可见性，只影响go get解析逻辑
为什么 main 包里的函数不能被其他包 import
main 包是程序入口，Go 规定它**不能被 import** —— 编译器会直接报错：cannot import "xxx/main"。这不是可见性问题，而是语言设计层面的禁止。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
想复用 main 里的逻辑？必须拆出独立包：
- 把核心逻辑移到
cmd/同级的pkg/或internal/目录下（如pkg/syncer） -
main.go只保留flag.Parse()、init()和main()调用链 -
internal/下的包默认不可被模块外引用（go mod语义限制），适合放私有工具逻辑
go mod tidy 后某些符号突然不可见了
这通常不是可见性规则变了，而是模块依赖发生了隐式升级或降级，导致你实际使用的版本中，某个本该导出的标识符被移除了、重命名了，或所在包被重构为非导出状态。
排查步骤：
- 运行
go list -m all | grep target确认当前加载的模块版本 - 对比该版本的源码（如
go mod download -d github.com/some/lib@v1.2.0，再查pkg/下对应文件） - 检查是否误用了
replace或exclude导致跳过了含导出符号的版本 - 注意：
go mod vendor后若手动删改vendor/内文件，也会绕过可见性校验，引发运行时 panic
最稳妥的做法：所有导出符号变更都应伴随语义化版本升级（如从 v1.2.x 升到 v2.0.0），并确保 go.mod 显式声明所需版本。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
