TensorBoard回调需显式创建并传入model.fit()才生效，关键参数包括log_dir（建议带时间戳的绝对路径）、histogram_freq、update_freq和write_graph；启动后需检查日志文件是否存在、端口是否正确、Runs菜单是否选中对应实验目录。
TensorBoard回调函数怎么写才生效
TensorBoard不是自动启动的，必须显式创建 tf.keras.callbacks.TensorBoard 回调并传入 model.fit()，否则日志根本不会写入。常见错误是只调用 tensorboard --logdir=logs/ 却没在训练中生成日志。
- 必须指定
log_dir参数，路径建议用绝对路径或确保相对路径相对于当前工作目录有效（例如"logs/fit/" + datetime.now().strftime("%Y%m%d-%H%M%S")） - 推荐开启
histogram_freq=1（每 epoch 记录一次权重直方图），但会显著拖慢训练，调试时可先设为 0 -
update_freq默认是"epoch"，若想每 batch 看 loss 变化，得设为整数如10（每 10 个 batch 记一次），但注意这会让日志体积暴增 - 别漏掉
write_graph=True（默认 True），否则看不到模型结构图
启动TensorBoard后看不到Loss曲线？检查这三处
启动命令 tensorboard --logdir=logs/fit 后页面空白或只有 Graph 标签，大概率是日志没写进去或路径错位。
- 确认
log_dir路径下是否真有时间戳子目录，且子目录内存在events.out.tfevents.*文件——没有就说明回调根本没运行 - 检查浏览器访问地址是否正确：默认是
http://localhost:6006/，不是 8080 或其他端口；如果被占用，用--port=6007换端口 - TensorBoard 页面左上角的「Runs」下拉菜单必须选中对应实验目录，否则会显示空面板；若多个实验混在一起，Loss 曲线可能被默认隐藏，需手动勾选
如何让训练时实时刷新Loss，而不是等全部结束才看到
TensorBoard 的「实时性」依赖两个条件：日志写入频率 + TensorBoard 自动重载机制。默认它每 30 秒轮询一次新事件，但你得先让事件写进去。
- 在
TensorBoard回调中设置update_freq="batch"或小整数（如5），否则 loss 只在 epoch 结束时记录一次 - 避免把
log_dir设成已存在的、含大量旧 events 文件的目录——TensorBoard 会加载所有历史数据，导致首次加载极慢，误以为「没刷新」 - 训练脚本运行后，立刻在终端执行
tensorboard --logdir=logs/fit --bind_all（加--bind_all防止仅监听 localhost），然后打开网页，切换到「Scalars」标签页 - 如果仍不刷新，点页面右上角「Reload data」按钮（闪电图标），或关掉再重开 TensorBoard 进程
多实验对比Loss时命名和目录结构怎么组织
直接把不同超参实验的日志全塞进同一 log_dir，会导致 Scalar 页面里曲线挤成一团、无法区分。TensorBoard 依赖目录层级识别实验名。
立即学习“Python免费学习笔记（深入）”；
- 每个实验单独一个子目录：
logs/fit/lr_0.001_batch32、logs/fit/lr_0.0001_batch64，这样「Runs」菜单会自动列出它们 - 避免在
log_dir中使用空格或中文，TensorBoard 解析可能出错；推荐用下划线连接单词 - 若用
datetime时间戳命名，记得在训练前生成并保存到变量，方便后续定位；不要在回调里重复调用datetime.now()，否则每次写日志都新建目录 - 想在 Scalars 页面对齐不同实验的 epoch 轴？确保所有实验的
epochs参数一致，否则横轴刻度会因总 step 数不同而错位
