TensorBoard 启动后看不到计算图，根本原因是未正确写入事件文件：必须确保 logdir 路径准确、writer 显式 flush、且在模型构建完成并执行一次前向传播后调用 tf.summary.trace_export（TF 2.x）或 tf.summary.FileWriter（TF 1.x）写入图结构。
TensorBoard 启动后看不到计算图？检查 logdir 和写入时机
TensorBoard 本身不主动抓取模型结构，必须由 TensorFlow 在训练前/构建阶段显式写入 tf.summary.FileWriter（TF 1.x）或 tf.summary.create_file_writer（TF 2.x）生成的事件文件。常见错误是：logdir 路径没写对、writer 没 flush、或者模型还没 build 就尝试写图。
- 确保 logdir 是绝对路径，且目录可写（
os.makedirs(logdir, exist_ok=True)） - TF 2.x 中必须在
@tf.function装饰的函数首次调用后，再调用writer.flush()，否则图可能为空 - 若用 Keras Model，推荐在
model.compile()后、model.fit()前调用tf.summary.trace_on(graph=True, profiler=False)，再执行一次前向推理（如model(tf.random.normal((1, 28, 28, 1)))），最后tf.summary.trace_export(...)
TF 2.x 下用 Keras 模型导出图的最小可行代码
不用手动构造 Session 或 Graph，靠 tf.summary + trace_on/trace_export 即可。关键在于触发一次真实的图构建（eager 模式下需显式 trace）。
import tensorflow as tf <p>model = tf.keras.Sequential([tf.keras.layers.Dense(10, input_shape=(784,))]) logdir = "./logs/graph" writer = tf.summary.create_file_writer(logdir)</p><p>tf.summary.trace_on(graph=True, profiler=False)</p><h1>必须执行一次前向传播，让图被构建并捕获</h1><p>_ = model(tf.random.normal((1, 784))) with writer.as_default(): tf.summary.trace_export(name="graph_trace", step=0)</p><h1>启动 TensorBoard：tensorboard --logdir=./logs/graph</h1><p>
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
注意：step=0 不可省略；name 参数影响左侧导航栏显示名；profiler=False 可避免额外开销。
为什么用 tf.keras.utils.plot_model 不等于 TensorBoard 图？
plot_model 输出的是 Keras 层级的静态结构图（SVG/PNG），仅含层连接关系；TensorBoard 的 Graph 页面展示的是底层的 Operation 级计算图（包括变量、控制依赖、梯度节点等），二者粒度和用途完全不同。
- 调试 shape 推导、梯度流、自定义 op 行为 → 必须用 TensorBoard Graph
- 向非技术人员展示模型概览 →
plot_model更直观 -
plot_model(show_shapes=True)会显示输入输出 shape，但无法反映实际运行时动态 shape（如 batch 维度为None）
常见报错：No dashboards are active for current data set
这不是 TensorBoard 启动失败，而是指定 logdir 下没有有效事件文件（event file）。重点排查：
- logdir 是否为空目录？检查是否有类似
events.out.tfevents.123456789.hostname的文件 - 是否误把 checkpoint 目录当 logdir？checkpoint 文件（
.index/.data）不会被 Graph 页面识别 - TF 版本混用：TF 2.10+ 默认使用新事件格式，旧版 TensorBoard（tensorboard --version 核对版本
- Windows 下路径含中文或空格？改用纯英文路径最稳妥
真正麻烦的不是启动，是让图“活”起来——它得经过一次真实执行，留下 trace，再被 writer 刷进磁盘。漏掉任意一环，页面就只剩一片空白。
