要在 PyCharm 中调试并启动你的 Streamlit
应用,可以按照以下步骤操作:
1. 配置 PyCharm 环境
确保 PyCharm 正确配置了 Python 解释器,且已经安装了 Streamlit。你可以通过以下步骤检查或设置:
- 打开 PyCharm,进入 File -> Settings。
- 在左侧选择 Project: [YourProjectName] -> Python Interpreter。
- 确保在当前 Python 解释器中安装了
streamlit
包。如果没有,点击+
号并搜索streamlit
,然后安装。
2. 配置 PyCharm 调试运行配置
-
在 PyCharm 中,打开 Run -> Edit Configurations。
-
点击左上角的
+
图标,选择 Python。 -
在右侧的 Name 字段中,给这个配置起一个名称,比如 "Streamlit Debug"。
-
在 Script path 中,填写
streamlit
的路径。如果你安装的是虚拟环境,可以通过以下命令找到streamlit
的路径:bashwhich streamlit
或者直接输入
streamlit run app.py
,例如:bashstreamlit run app.py
-
在 Parameters 中,填写
app.py
,即你的Streamlit
应用入口文件名称。 -
在 Working directory 中,确保选择的是你项目的根目录。
-
还可以根据需要设置 Environment variables,比如你需要的环境变量,或调试信息:
bashSTREAMLIT_SERVER_PORT=8501
-
点击 Apply 和 OK,保存配置。
3. 启动调试
- 在 PyCharm 的顶部工具栏,选择你刚才创建的 "Streamlit Debug" 配置,然后点击调试按钮(带虫子的绿色按钮)以调试模式运行应用。
4. 设置断点进行调试
- 在
app.py
或你希望调试的其他页面(如knowledge_base_list.py
、create_knowledge_base.py
)中,点击左侧行号边缘来设置断点。 - 当应用运行到断点处时,程序会暂停,你可以检查变量状态、单步执行代码等。
5. 调试页面动态加载
Streamlit 应用支持实时热加载,也就是说你可以在调试时修改代码并看到即时变化。配合 PyCharm 的调试工具,你可以在页面之间切换,并通过断点查看页面组件的运行情况。
6. 运行调试的注意事项
- 在页面有输入、按钮等交互时,调试模式下可以看到交互对程序逻辑的影响。
- 如果你遇到调试不生效的情况,可以尝试通过
Ctrl+C
停止正在运行的streamlit
服务器,重新启动调试。