LangGraph子图可视化仅显示外层节点，如何展示全部内部节点？

默认情况下，StateGraph生成Mermaid图表时会把嵌套的子图当作单个节点渲染，要看到内部节点，得手动展开或者自定义渲染逻辑：

方案1：手动合并子图的Mermaid代码 #

直接提取每个子图的内部Mermaid结构，嵌套到主图的代码里：

1. 先拿到主图和各子图的Mermaid代码
2. 把主图里的子图节点（比如"A"）替换成Mermaid的subgraph块，把对应子图的内部节点和边放进去
3. 处理节点名称冲突（给子图内部节点加前缀，比如A_xxx）

示例代码：

# 获取主图的Mermaid代码
main_mermaid = main_graph.get_graph().draw_mermaid()

# 提取子图内部的Mermaid内容（去掉开头的graph声明）
def get_subgraph_content(sub_graph):
    sub_mermaid = sub_graph.get_graph().draw_mermaid()
    # 拆分出graph声明后的部分
    return sub_mermaid.split('graph TD')[1].strip()

# 替换主图中的子图节点为嵌套子图
final_mermaid = main_mermaid
for name, sub_graph in [("A", graph_a), ("B", graph_b), ("C", graph_c)]:
    sub_content = get_subgraph_content(sub_graph)
    # 给子图内部节点加前缀避免冲突
    prefixed_content = sub_content.replace("\n", f"\n  {name}_").replace(f"--> {name}_", "--> ")
    final_mermaid = final_mermaid.replace(name, f"subgraph {name}\n  {prefixed_content}\nend")

# 输出完整Mermaid代码
print(final_mermaid)

方案2：自定义渲染逻辑 #

如果经常需要展开子图，可以重写StateGraph的图表渲染方法，递归遍历所有子图并展开：

• 检查每个节点是否是子图类型（比如isinstance(node, StateGraph)）
• 递归生成子图的内部结构，自动给节点加唯一前缀
• 把展开后的结构合并到主图的Mermaid代码中

关键注意点 #

• 子图如果有明确的入口/出口节点，主图的边要指向这些内部节点，而不是子图本身
• 必须处理节点名称冲突，不同子图的内部节点要加前缀区分

内容的提问来源于stack exchange，提问作者Chris