Streamlit 中 st.button(..., on_click=...) 的回调函数会在脚本重运行开始前执行，因此其中的 st.* 组件（如 st.success）会渲染在页面顶部；若需控制输出位置，应改用 if st.button(): 模式，或通过 st.session_state 触发后续条件渲染。
streamlit 中 `st.button(..., on_click=...)` 的回调函数会在脚本重运行**开始前**执行，因此其中的 `st.*` 组件（如 `st.success`）会渲染在页面顶部；若需控制输出位置，应改用 `if st.button():` 模式，或通过 `st.session_state` 触发后续条件渲染。
Streamlit 的核心机制是「每次交互后完整重运行整个脚本」。当你点击一个带 on_click 的按钮时，Streamlit 并不会在按钮所在位置暂停并执行回调，而是先执行 on_click 函数（此时页面尚未重建），再从头开始逐行执行脚本。这意味着：所有在 on_click 回调中调用的 st.write、st.success、st.dataframe 等组件，都会被插入到本次重运行的初始渲染流最前端——也就是页面顶部，而非按钮下方。
例如，以下代码会导致 "Done!" 总出现在页面最上方：
def onSearch(opt):
st.success("Done!") # ❌ 渲染位置不可控，总在顶部
st.button("Find", on_click=onSearch, args=["query"])
这不是 bug，而是设计使然：on_click 的定位是「副作用前置触发器」，适用于需立即生效且无需 UI 位置感知的操作，比如：
- 更新 st.session_state 变量（推荐且最常用）；
- 记录日志、调用 API、写入数据库等无界面副作用；
- 触发后台任务（如启动线程或异步任务）。
✅ 正确做法：用 st.session_state 作为桥梁，将状态变更与 UI 渲染解耦：
import streamlit as st
# 初始化状态
if "search_done" not in st.session_state:
st.session_state.search_done = False
def onSearch(option):
# 仅做状态变更或副作用操作
st.session_state.search_done = True
# ✅ 可安全添加：logging.info(f"Searched for {option}")
# ✅ 可安全添加：requests.post("/api/search", json={"q": option})
def drawBtn():
option = st.text_input("Enter search term")
st.button("Find", on_click=onSearch, args=[option])
drawBtn()
# 在脚本靠后位置，根据状态条件渲染结果
if st.session_state.search_done:
st.success("✅ Done! Results will appear below.")
# 这里可继续添加 st.dataframe、st.plotly_chart 等——位置完全可控
⚠️ 注意事项：
- on_click 函数不能依赖当前脚本中的局部变量或未初始化的 st.session_state 键（除非你确保它已预设）；
- 避免在 on_click 中直接调用 st.experimental_rerun() —— 它会引发重复重运行，造成不可预测行为；
- 若逻辑简单且对渲染位置敏感，优先选择 if st.button("..."): 模式，语义清晰、位置确定、调试友好：
if st.button("Find"):
# 所有 st.* 调用都紧随按钮之后，位置可预期
st.success("✅ Done!")
# 后续组件自然出现在 success 下方
总结：on_click 是「状态驱动」开发的关键工具，不是「UI 插入」工具。善用 st.session_state 做状态中介，配合条件渲染，才能兼顾响应性与布局可控性——这是构建健壮 Streamlit 应用的核心实践之一。
