streamlit 能用纯 python 5 分钟构建交互式 web 应用，无需 html/css/js；必须用 streamlit run app.py 启动以启用热重载和运行时机制，禁用 python app.py；推荐 st.dataframe() 和 st.pyplot() 替代 st.write() 提升性能与控制力；状态需用 st.session_state 显式管理；部署前应锁定 python 3.8–3.10 及 streamlit==1.34.0。
Streamlit 能让你用纯 Python 在 5 分钟内跑出一个可交互的 Web 应用，不需要写任何 HTML/CSS/JS —— 只要你会 print，就能做出带输入框、图表和实时响应的界面。
streamlit run 命令必须用对，否则脚本不生效
很多人写完 app.py 后直接执行 python app.py，结果浏览器打不开，页面也没反应。这是因为 Streamlit 不是普通脚本，它需要自己的运行时环境和重载机制。
- 正确命令永远是：
streamlit run app.py（不是python app.py） - 如果提示
command not found，说明没装好或没激活虚拟环境 - 支持远程路径：
streamlit run https://raw.githubusercontent.com/xxx/app.py，适合快速试跑别人代码 - 保存文件后，浏览器会自动刷新 —— 这个热重载依赖
streamlit run启动，python直接运行完全没这功能
st.write() 是万能兜底函数，但别滥用在表格和图表上
st.write() 确实省心：传 str、dict、pd.DataFrame、甚至 plt.figure 都能自动识别并渲染。但它对性能和控制力是妥协的。
- 显示表格时，优先用
st.dataframe(df)：支持列排序、缩放、复制，st.write(df)只是静态快照 - 画图时，
st.pyplot(fig)比st.write(fig)更可靠，尤其涉及中文标签、字体或tight_layout时 -
st.write("hello")和st.text("hello")效果不同：前者支持 Markdown 解析，后者纯文本，无格式风险
输入控件的状态管理容易被忽略，导致逻辑错乱
Streamlit 的控件（如 st.slider、st.selectbox）每次重运行都会重新生成 —— 它们没有“记忆”，除非你显式处理状态。
- 常见问题：用户调完滑块，点按钮提交，结果滑块值回退到初始值 → 因为按钮触发重运行，控件重建，未保存上次值
- 解法是用
st.session_state：比如st.session_state.setdefault("threshold", 0.5)初始化，再让st.slider(..., value=st.session_state.threshold) - 注意：
st.button每次点击都返回True一次，不能当开关用；真要 toggle，得配合st.session_state手动翻转布尔值
部署前必须检查 Python 版本和依赖兼容性
本地跑通 ≠ 上线可用。Streamlit 在 Python 3.11+ 上部分依赖（如 watchdog）存在静默失败，而生产环境常默认最新版。
- 推荐锁定 Python 3.8–3.10：用
python --version确认，conda 创建环境时明确指定python=3.9 -
requirements.txt必须包含streamlit==1.34.0（当前稳定版），避免自动升级到有 breaking change 的新版 - 若用 Plotly，加一行
plotly>=5.18.0：旧版在 Streamlit 中可能无法响应 hover 或点击事件 - 本地开发用
streamlit hello验证基础组件是否正常，比空跑自己代码更早暴露环境问题
最常被跳过的一步是：没在代码开头加 if __name__ == "__main__": 就直接跑 streamlit run —— 多数时候不报错，但一旦引入模块级副作用（比如初始化数据库连接、加载大模型），就会重复执行多次，轻则卡顿，重则崩溃。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
