viper.ReadInConfig()报“Config File Not Found”主因是未显式设置路径、文件名和类型；它默认仅在当前工作目录查一次，不递归、不猜路径、不识别后缀，必须调用AddConfigPath、SetConfigName和SetConfigType才能正确定位并解析配置文件。
Go 没有内置配置加载机制，所有「自动发现」「多格式支持」「环境变量覆盖」都得手动控制；不显式设 viper.SetConfigType 或不传对路径，viper.ReadInConfig() 必然失败——这不是配置写错了，是加载逻辑没对齐。
为什么 viper.ReadInConfig() 总报 “Config File Not Found”
不是文件丢了，是你没告诉 viper 去哪找、叫什么名、是什么格式。
-
viper默认只在os.Getwd()返回的当前工作目录里查一次，不递归、不猜路径、不扫./configs或./etc - 必须调用
viper.AddConfigPath("./configs")（可多次），它才按添加顺序逐个目录查找 -
viper.SetConfigName("app")+viper.SetConfigType("yaml")→ 它只找app.yaml，不是config.yaml - 构建或测试时工作目录易变，建议启动时加一行
fmt.Println("cwd:", os.Getwd())确认实际位置
为什么 SetConfigType("yaml") 是硬性要求
后缀不是万能的。viper 只认有限后缀列表（.yaml、.yml、.json 等），遇到 config（无后缀）、app.conf 或 embed.FS 读出的字节流，它根本不会尝试推断格式。
-
viper.SetConfigType("yaml")必须在viper.ReadInConfig()或viper.ReadConfig()之前调用 - 类型名必须准确：
"yaml"、"json"、"toml"，不能写成"yml"（部分版本兼容但不保证） - 用
embed.FS读取后调viper.ReadConfig(bytes.NewReader(data))时，viper.SetConfigFile()完全无效，SetConfigType是唯一出路 - YAML 文件里混入 tab 缩进会直接 panic：
While parsing config: yaml: line X: did not find expected key，必须用空格缩进
结构体字段全是零值？90% 是导出或 tag 问题
gopkg.in/yaml.v3（或 viper.Unmarshal 底层用的解析器）只能访问首字母大写的导出字段，且 yaml:"key_name" 必须严格匹配 YAML 中的 key（区分大小写、下划线、空格）。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
立即学习“go语言免费学习笔记（深入）”；
- 字段写成
port int（小写）→ 解析器跳过，不报错也不赋值 - tag 写成
yaml:"Port"，但 YAML 里是port: 8080→ 匹配失败，留零值 - 嵌套结构漏了外层 tag，例如
Server ServerConfig `yaml:"server"`忘了这个`yaml:"server"`→ 整个子结构不会被解析 - 用
viper.AllSettings()能打印出原始数据，但结构体字段仍为零？说明解析成功了，问题一定出在结构体定义上
测试时 config.yaml 找不到路径怎么办
go test ./pkg 的当前工作目录是 ./pkg/，不是项目根目录，相对路径 "config.yaml" 自然失效。别改 os.Chdir()，也别在 init() 里自动加载——那会让测试和运行时行为不一致。
- 把路径作为参数传入：配置加载函数定义为
func Load(configPath string) error，内部用os.ReadFile(configPath) -
main.go调用Load("config.yaml")（项目根下） -
test.go调用Load("../config.yaml")或用filepath.Join("..", "config.yaml") - 更健壮的做法是用
runtime.Caller(0)获取调用方位置再向上找项目根，但多数场景直接传相对路径已足够
最常被忽略的点是：viper 的行为高度依赖调用顺序——AutomaticEnv() 必须在 ReadInConfig() 之前，SetConfigType() 必须在 ReadConfig() 之前，任何一步颠倒，覆盖逻辑或解析都会静默失效。
