Streamlit循环更新metric时如何复用同一元素而非重复创建

Streamlit默认采用全脚本顺序渲染的执行逻辑，每次调用组件渲染方法时，都会在当前页面流末尾追加新元素，不会自动替换之前生成的同类型组件。循环中反复调用st.metric()会生成多个堆叠的指标组件，无法实现单元素更新效果。

使用st.empty()创建固定位置的单元素占位容器是最简单的实现方式：提前在需要展示指标的位置声明占位容器，后续所有更新操作都针对该容器执行，新写入的内容会直接覆盖容器内的旧内容，不会生成新的堆叠元素。

修改后的可直接运行代码：

import streamlit as st
import time

# 初始化固定位置的指标占位符
temp_display = st.empty()

for x in range(10):
    # 向占位符写入新内容，自动覆盖上一次渲染结果
    temp_display.metric(
        label="Temperature",
        value=f"7{x} °F",
        delta="1.2 °F"
    )
    time.sleep(2)

扩展提示 #

• 若单页需要更新多个固定位置的元素，只需按目标页面排列顺序，提前声明多个st.empty()占位符，分别对对应占位符执行渲染操作即可，不会出现元素堆叠问题。
• 若更新逻辑需要结合用户交互（如点击按钮触发更新、暂停更新），可搭配st.session_state存储更新状态，和占位符方案配合使用即可。

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