如何在Python（Jupyter）中运行Streamlit？求助排查运行问题

1. 确认Streamlit安装有效性 #

打开系统终端（不是Jupyter单元格），执行pip show streamlit，查看是否有版本、安装路径等完整信息。如果无输出，说明安装不完整，重新执行pip install streamlit；用conda环境的话，换成conda install -c conda-forge streamlit。

2. 切换正确的命令执行环境 #

• 禁止在Jupyter代码单元格直接运行streamlit run <filename.py>，必须在系统终端/命令提示符操作：
  • Windows：打开CMD或PowerShell，用cd命令切换到你的.py文件所在目录，再执行启动命令。
  • macOS/Linux：打开终端，同样通过cd定位到文件目录后执行命令。
  • 若非要在Jupyter内尝试，需给命令加感叹号前缀：!streamlit run <filename.py>，但仍推荐用终端避免环境冲突。

3. 用最简测试文件验证 #

先创建一个极简测试文件test.py，内容如下：

import streamlit as st
st.write("Hello Streamlit!")

在终端执行streamlit run test.py，观察是否有反应。如果这个基础文件都无法启动，说明环境存在核心问题。

4. 排查虚拟环境冲突 #

• 如果你用了虚拟环境，先确认已激活目标环境（比如conda activate 你的环境名，或venv的activate命令），再执行Streamlit启动命令。
• 检查Python版本：Streamlit仅支持3.8-3.12版本，执行python --version确认版本符合要求，不符合则切换对应版本的环境。

5. 查看详细调试日志 #

执行启动命令时添加调试参数：streamlit run test.py --logger.level=debug，会输出详细运行日志，从中查找是否有端口占用、权限不足等报错信息。

6. 手动指定端口启动 #

若默认端口8501被占用，尝试指定其他端口：streamlit run test.py --server.port=8502，之后手动在浏览器输入http://localhost:8502，查看能否打开应用。

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