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 的核心执行模型是「全脚本重运行（full-script rerun）」：每次用户交互（如点击按钮、输入文本）都会从头到尾重新执行整个 Python 脚本。理解 on_click 的执行时机，是避免 UI 错位的关键。
? 为什么 on_click 中的 st.success() 出现在页面顶部？
当你写：
def onSearch(opt):
st.success("Done!") # ❌ 此行在本次 rerun 的「最早阶段」执行
st.button("Find", on_click=onSearch, args=[option])Streamlit 会在真正解析 st.button() 之前，先调用 onSearch 回调（并传入参数），此时脚本尚未执行到页面其他 st.* 组件——因此 st.success("Done!") 被插入到 DOM 的起始位置，表现为“跳到顶部”。
这与 if st.button(): 的行为本质不同：
if st.button("Find"): # ✅ 返回 True 仅当本次点击发生，且在此处「即时」判断
st.success("Done!") # 渲染位置严格对应代码书写顺序（即按钮下方）此处 st.button() 是一个有返回值的表达式，其 True 结果仅在当前 rerun 中该按钮被点击时才成立，st.success() 随即在按钮之后按顺序渲染，完全符合直觉。
✅ 正确使用 on_click 的两种推荐模式
✅ 模式一：仅操作 st.session_state（推荐用于状态同步）
on_click 最安全、最常用的用途是原子化更新状态，不产生任何 UI 输出：
if "search_result" not in st.session_state:
st.session_state.search_result = None
def onSearch(option):
# 纯逻辑处理（如 API 调用、数据计算）
result = f"Processed: {option}"
st.session_state.search_result = result # ✅ 只设 state，不调 st.*
st.button("Find", on_click=onSearch, args=["user_input"])随后在脚本任意靠后位置按需渲染结果：
if st.session_state.search_result:
st.success(f"✅ {st.session_state.search_result}")这样既利用了 on_click 的即时性（避免重复计算），又保证了 UI 渲染位置可控。
✅ 模式二：配合 key 实现「点击即生效」的前置反馈
若需在按钮上方显示提示（例如点击后立即禁用按钮），可结合 key 和 st.session_state：
if "is_searching" not in st.session_state:
st.session_state.is_searching = False
def start_search():
st.session_state.is_searching = True
# 按钮带 key，自动绑定 session_state 变量（隐式）
st.button(
"Find" if not st.session_state.is_searching else "Searching...",
on_click=start_search,
disabled=st.session_state.is_searching,
key="search_btn"
)
# 后续逻辑（如模拟耗时操作）
if st.session_state.is_searching:
with st.spinner("Running..."):
time.sleep(1)
st.session_state.search_result = "Success!"
st.session_state.is_searching = False
if st.session_state.get("search_result"):
st.success(st.session_state.search_result)⚠️ 注意事项总结
- on_click 回调不接收 st 上下文，不能依赖当前 widget 位置；它本质是「预执行钩子」。
- 不要在 on_click 中直接调用 st.write, st.dataframe, st.plotly_chart 等渲染函数——它们必然出现在页面开头。
- 所有副作用（如文件写入、数据库更新、API 请求）可在 on_click 中安全执行，但 UI 响应必须延迟到主脚本流中处理。
- 若逻辑简单且无需复用，优先选择 if st.button(): —— 更直观、更易维护、位置确定。
掌握这一机制，你就能在保持 Streamlit 声明式风格的同时，精准掌控交互响应的位置与时机。
