Gin模板无法直接读取config.yaml，必须通过c.HTML()显式传入配置字段；推荐用map[string]any传关键参数，或用FuncMap注入cfg函数实现热更新。
模板里直接读不到 config.yaml 里的值
Gin 的 HTML 模板（html/template）本身不接触配置文件，它只接收 c.HTML() 传入的 data。想在模板里用系统参数，必须先从配置中读出来，再显式传进去。
常见错误是试图在模板里写 {{ .Config.AppName }} 却没把 Config 结构体塞进 data —— 这会静默渲染为空，或报 nil pointer 错误（取决于字段访问方式）。
- 配置加载通常在
main()或初始化阶段完成，比如用viper.ReadInConfig() - 模板渲染前，需将配置结构体（或部分字段）作为 map 或 struct 传入
c.HTML()的第二个参数 - 避免全局变量传 config：并发下可能被意外修改；应每次渲染时取当前快照
推荐做法：用 map[string]any 传关键配置字段
比传整个 config struct 更安全、更轻量，也避免模板里意外访问到敏感字段（如 Database.Password）。
示例（假设已用 viper 加载了 config.yaml）：
// 在 handler 中
c.HTML(http.StatusOK, "index.html", map[string]any{
"AppName": viper.GetString("app.name"),
"Version": viper.GetString("app.version"),
"DebugMode": viper.GetBool("app.debug"),
})
模板中即可直接使用：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
<title>{{ .AppName }} v{{ .Version }}</title>
<meta name="env" content="{{ if .DebugMode }}dev{{ else }}prod{{ end }}">
- 字段名全小写（如
AppName）可直接在模板中点取；若用app_name需转成首字母大写才能导出（Go struct 字段必须导出） - 不要传
viper实例本身进模板 —— 它不是线程安全的，且模板无法调用其方法 - 如果多个路由都需要相同配置，可封装一个
render(c *gin.Context, tmpl string, data map[string]any)辅助函数统一注入
进阶：用自定义 template.FuncMap 注入配置函数
适合需要动态读取配置（比如按 locale 切换文案）、又不想每个 handler 都手动传字段的场景。
在初始化模板时注册函数：
func newTemplate() *template.Template {
t := template.New("").Funcs(template.FuncMap{
"cfg": func(key string) any {
return viper.Get(key)
},
"cfgString": func(key string) string {
return viper.GetString(key)
},
})
return template.Must(t.ParseGlob("templates/*.html"))
}
// 然后 gin.SetHTMLTemplate(t)
模板中调用：
<h1>{{ cfgString "app.name" }}</h1>
<span>{{ cfg "features.enable_analytics" | printf "%t" }}</span>
- 注意
cfg返回的是any，模板中需配合printf或类型判断函数（如isBool）使用 - 这种写法会让模板和配置强耦合，调试时难追踪数据来源；建议仅用于 truly 全局、极少变动的参数
- 别在
cfg函数里做复杂逻辑（如嵌套读取 + 默认 fallback），应提前在 Go 层处理好
容易被忽略的坑：热重载配置时模板不更新
如果用了 viper.WatchConfig() 动态更新配置，但模板已经渲染过一次，后续请求仍显示旧值 —— 因为 cfgString 函数每次调用都读最新 viper，但 map 方式传参是“快照”行为。
- 用 FuncMap 方式能自动响应配置变更，但要注意：viper 的 watch 机制本身有延迟，且不会触发模板重新编译
- map 传参方式要自己加逻辑：比如在 middleware 中每次请求都重建 data map，或监听
viper.OnConfigChange后清空缓存 - 最稳妥的做法是：只对真正需要热更新的参数用 FuncMap；其余静态参数（如 AppName）仍走 map 传参，靠重启服务更新
配置不是模板变量，它得有人推过去，或者有人拉过来 —— 关键在谁控制时机、谁承担一致性责任。
