如何避免Streamlit应用因用户输入触发整体重运行？

以下是几种可行的方案，帮你避免切换selectbox时重新渲染所有内容：

1. 用会话状态分离静态与动态内容 #

把不需要随选项变化的静态内容（标题、已缓存的图表/图片等）放在首次加载的判断逻辑里，后续切换选项时跳过这部分代码的执行：

import streamlit as st

# 初始化会话状态标记，判断是否首次加载
if "first_load" not in st.session_state:
    st.session_state.first_load = True

if st.session_state.first_load:
    st.title('Hello App')
    # 这里放所有静态内容：已缓存的图表、图片、固定逻辑等
    # Lots of code, inputs, charts, functions, images, etc...
    # 首次加载完成后标记为False，后续不再执行这部分
    st.session_state.first_load = False

# 仅随selectbox变化的动态部分
animal = st.selectbox('What do you want to learn more about?', ['Dogs', 'Cats', 'Fish'])
st.write(f'Ok, let me tell you about {animal}')

注意：如果静态内容里有依赖其他用户输入的组件，需要调整会话状态的判断逻辑，确保只跳过真正无需重复渲染的部分。

2. 用容器结合会话状态控制渲染 #

将静态内容放入st.container()，仅在首次加载时填充容器内容，后续切换选项时容器内容会保留，不会重新渲染：

import streamlit as st

static_container = st.container()

if "static_loaded" not in st.session_state:
    with static_container:
        st.title('Hello App')
        # 填充所有静态内容
        # Lots of code, inputs, charts, functions, images, etc...
    st.session_state.static_loaded = True

# 动态内容部分
animal = st.selectbox('What do you want to learn more about?', ['Dogs', 'Cats', 'Fish'])
st.write(f'Ok, let me tell you about {animal}')

3. 拆分应用为多页面结构 #

把公共静态内容放在主页面，将不同动物的动态内容拆分为独立子页面，通过导航切换时仅加载对应子页面的内容：

# main.py
import streamlit as st
from pages import dogs, cats, fish

# 公共静态内容，仅渲染一次
st.title('Hello App')
# 这里放所有公共静态内容

# 选项选择
page = st.selectbox('What do you want to learn more about?', ['Dogs', 'Cats', 'Fish'])

# 根据选择加载对应子页面的动态内容
if page == 'Dogs':
    dogs.show()
elif page == 'Cats':
    cats.show()
elif page == 'Fish':
    fish.show()

每个子页面（如dogs.py）只处理对应动物的动态逻辑，避免整体页面重复渲染。

4. 优化缓存的细粒度控制 #

确保所有数据处理、图表生成函数都使用合适的缓存装饰器（st.cache_data用于数据，st.cache_resource用于资源），并精准设置缓存键，避免不必要的缓存失效：

@st.cache_data
def generate_static_chart(fixed_data):
    # 基于固定数据生成图表的逻辑
    return chart

# 调用时仅当fixed_data变化才重新生成图表
static_chart = generate_static_chart(固定数据源)

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