go run 无法直接执行可视化报告生成器，因go无内置图形渲染或html模板服务，需手动生成静态文件（如report.html）或启动http服务；若未调用generatereport()或http.listenandserve，程序将无响应。
为什么 go run 无法直接执行可视化报告生成器
Go 本身不带图形渲染或 HTML 模板服务运行时，所谓“自动生成可视化报告”必须落地为静态文件（如 report.html）或启动本地 HTTP 服务。直接 go run main.go 后没反应、浏览器打不开、控制台无输出——大概率是卡在等待手动触发生成，或默认没启用 HTTP server。
- 检查
main()是否调用了generateReport()，还是只注册了http.HandleFunc却没调http.ListenAndServe - 若目标是离线报告，确保代码里明确写了
ioutil.WriteFile("report.html", data, 0644)或等效的os.WriteFile - 若走 HTTP 方式，
http.ListenAndServe(":8080", nil)后必须访问http://localhost:8080/report这类路径，不是打开 localhost 就自动出报告
用 html/template 渲染集群指标时变量名对不上
常见现象：页面显示大量 {{.CPUUsage}} 原样未替换，或报错 template: report.html:12: undefined variable "$node"。根本原因是 Go struct 字段未导出，或模板中引用路径与数据结构嵌套层级不匹配。
- 所有要传入模板的 struct 字段必须大写开头（即导出），例如
CPUUsage float64✅，cpuUsage float64❌ - 如果传入的是
map[string]interface{}，模板里不能写{{.Nodes[0].CPU}}，得先用range展开：{{range .Nodes}}{{.CPU}}{{end}} - 避免在模板里做计算，比如
{{.MemoryUsed / .MemoryTotal * 100}}—— Go 模板不支持浮点运算，提前算好放进字段更稳
k8s.io/client-go 获取 Pod 列表后内存暴涨
一次性拉取整个集群所有命名空间的 Pod，再用 json.MarshalIndent 转成字符串塞进模板，很容易触发几百 MB 内存占用。这不是 bug，是没做裁剪和分页的典型后果。
- 用
ListOptions限制范围：clientset.CoreV1().Pods("default").List(ctx, metav1.ListOptions{Limit: 50}) - 不要把原始
*corev1.PodList整个传给模板，定义轻量 DTO struct，只保留需要字段：type PodSummary struct { Name, Status, CPU, Memory string } - 如果真要全量分析，改用
Watch+ 流式处理，或导出为 CSV/JSON 文件由前端加载，别硬塞进 HTML
生成的 HTML 报告在 Chrome 打开空白，但源码可见
最常被忽略的是资源路径问题：CSS/JS 是相对路径，而双击 report.html 用 file:// 协议打开时，浏览器会拦截 fetch 或禁止 localStorage，导致图表库（如 Chart.js）初始化失败，页面留白。
立即学习“go语言免费学习笔记（深入）”；
- 本地验证务必用
python3 -m http.server 8000或go run -m httpserver启一个最小服务，再访问http://localhost:8000/report.html - 避免在模板里写
<script src="./chart.min.js"></script>，改成内联或使用 CDN：<script src="https://cdn.jsdelivr.net/npm/chart.js"></script> - 检查浏览器控制台是否报
Blocked script execution in 'about:blank'...—— 那基本就是file://协议惹的祸
真正麻烦的从来不是生成 HTML，而是让指标数据能对得上时间点、命名空间没漏、状态字段没歧义。比如 Pod.Status.Phase == "Running" 不代表就绪，还得看 Pod.Status.Conditions 里的 Ready；这种细节一漏，报告看着漂亮，实际没法用。
