streamlit 的 st.session_state 仅在通过 streamlit run 启动应用时才被完整初始化；若直接用 python script.py 执行，会因运行时环境缺失而触发 keyerror，即使代码中已做键存在性检查。
streamlit 的 st.session_state 仅在通过 streamlit run 启动应用时才被完整初始化；若直接用 python script.py 执行，会因运行时环境缺失而触发 keyerror，即使代码中已做键存在性检查。
Streamlit 并非普通 Python 脚本框架，而是一个基于 Web 的交互式应用运行时。其核心机制（如 session state、widget 状态管理、重渲染逻辑）高度依赖 Streamlit 自身的运行时环境（streamlit.runtime）。当你执行：
python app.py
Python 解释器只是顺序执行脚本，此时 st.session_state 尚未被 Streamlit 运行时初始化——它甚至不是一个可用的字典对象，而是一个占位代理（SessionStateProxy），所有对它的读写操作都会失败，包括 in st.session_state.keys() 这类看似安全的检查。这也是你看到 KeyError: 'st.session_state has no key "show_text"' 的根本原因：不是键没初始化，而是整个 st.session_state 对象尚未就绪。
✅ 正确启动方式（唯一推荐）：
streamlit run app.py
该命令会启动 Streamlit 运行时，自动完成 session state 的初始化，并确保每次用户交互（如点击按钮）都触发完整的重运行（rerun）流程，此时 st.session_state 始终处于可读写状态。
⚠️ 为什么“看似能跑”的第二个例子不报错？
你观察到的“无错误”现象具有误导性：
- 在 python app.py 下，st.button("Show text!") 实际不会渲染任何 UI，也不会注册交互逻辑；
- st.write(st.session_state["show_text"]) 这一行根本不会执行（因为按钮未被点击，条件分支未进入）；
- 更关键的是：st.button 在非 Streamlit 运行时环境下返回 False 恒定值，且不触发任何状态变更。因此代码看似“静默通过”，实则完全未触发 session state 的访问路径——这属于假阴性，不能作为正确性的依据。
? 最佳实践：始终使用 streamlit run + 显式初始化（双重保障）
虽然 streamlit run 已保证 st.session_state 可用，但为提升代码健壮性和可读性，仍建议采用“存在性检查 + 初始化”的惯用模式：
import streamlit as st
# ✅ 推荐：在主逻辑开头统一初始化所需状态
if "show_text" not in st.session_state:
st.session_state.show_text = False # 支持点号访问，更简洁
st.markdown("# My App")
if st.button("Show text!"):
st.session_state.show_text = True
if st.session_state.show_text: # 直接布尔判断，无需 is True
st.markdown("Lorem ipsum...")
? 注意事项：
- 不要使用 python your_script.py 测试或调试 Streamlit 应用——它无法模拟真实运行环境；
- 初始化逻辑应放在 st 组件调用之前（如 st.button、st.text_input 之前），避免在未初始化状态下意外访问；
- 优先使用属性访问语法（st.session_state.key）替代字典键访问（st.session_state["key"]），更符合 Streamlit 官方风格且支持 IDE 类型提示；
- 若需单元测试 session state 行为，请使用 streamlit.testing 模块（v1.30+）或 mock 运行时，而非直接执行脚本。
总结：KeyError 不是代码逻辑缺陷，而是启动方式错误导致的环境缺失。牢记——Streamlit 应用 ≠ 普通 Python 脚本，一切交互能力均以 streamlit run 为前提。
