本文介绍在 streamlit 中正确实现“点击按钮后立即禁用、昂贵操作完成后自动重新启用”的交互逻辑，解决因应用重运行机制导致的状态同步问题，并提供稳定、无需手动刷新的纯 python 方案。
本文介绍在 streamlit 中正确实现“点击按钮后立即禁用、昂贵操作完成后自动重新启用”的交互逻辑，解决因应用重运行机制导致的状态同步问题，并提供稳定、无需手动刷新的纯 python 方案。
Streamlit 的 UI 是无状态重渲染（stateless re-render）驱动的：每次用户交互（如点击按钮）都会触发整个脚本从头执行，st.session_state 虽可持久化数据，但按钮的 disabled 参数仅在当前渲染周期生效。因此，若仅在 if but: 块中修改 st.session_state.disabled = True，该变更无法影响本次渲染中已生成的按钮——它已在上一轮渲染中被创建并固定为 disabled=False。
关键在于：必须让按钮的 disabled 状态由 st.session_state 在每次渲染时动态决定，且需确保状态更新逻辑不被误触发。以下是经过验证的可靠实现方案：
✅ 正确做法：使用 st.form + st.session_state 双重保障
import time
import streamlit as st
def expensive_process():
time.sleep(3) # 模拟耗时操作（实际中可替换为模型推理、数据库查询等）
return 123
# 初始化状态（仅首次加载时设置）
if "calc_running" not in st.session_state:
st.session_state.calc_running = False
# 使用表单确保原子提交，避免多次意外触发
with st.form("calc_form"):
submit_btn = st.form_submit_button(
"Calculate",
disabled=st.session_state.calc_running # 动态绑定禁用状态
)
# 处理表单提交（仅当点击且未处于运行中时执行）
if submit_btn and not st.session_state.calc_running:
st.session_state.calc_running = True
st.rerun() # 立即重运行，使按钮在新轮次中显示为 disabled
# 若当前处于运行中，则执行任务并更新结果
if st.session_state.calc_running:
status_placeholder = st.empty()
status_placeholder.markdown("⏳ Running expensive operation...")
result = expensive_process()
st.session_state.calc_running = False
status_placeholder.markdown(f"✅ Done! Result: **{result}**")
st.rerun() # 清除运行态，恢复按钮可用? 为什么这样更可靠？
- st.form_submit_button 提供了明确的“提交事件”，比普通 st.button 更适合有副作用的操作；
- st.rerun() 显式控制重运行时机，确保状态变更（如 calc_running=True）能立即反映在 UI 上；
- 双重条件检查（if submit_btn and not st.session_state.calc_running）防止并发或重复触发；
- 无外部依赖，不需手动“Refresh”按钮，完全自动化。
⚠️ 注意事项
- ❌ 避免在按钮回调中直接修改 disabled= 参数值——它只作用于当前渲染帧；
- ❌ 不要将 st.session_state 初始化放在函数体顶层（如原代码中的 st.session_state.disabled = False），否则每次重运行都会覆盖；
- ✅ 推荐始终使用 if "key" not in st.session_state: 模式初始化状态；
- ✅ 对真实耗时操作（如 API 调用），建议配合 st.spinner() 或 st.status() 提升用户体验：
with st.status("Processing...", expanded=True) as status:
result = expensive_process()
status.update(label="Complete!", state="complete", expanded=False)通过以上模式，你就能在 Streamlit 中优雅、健壮地实现「操作进行中按钮自动禁用」这一常见交互需求，无需 hack、不依赖刷新、符合框架设计哲学。
