fJDkW13Dn 发表于 2025-2-28 20:48:38

关于我在使用Steamlit中碰到的问题及解决方案总结

Steamlit 并不支持一个可以预览本地文件的路径选择器(并不上传文件)

解决方案:使用 Python 自带的 tkinter 来完成
参考:【Streamlit 选择文件夹的曲折方案】Streamlit选择文件夹-CSDN博客
import streamlit as stfrom tkinter import filedialog, Tk# Set up tkinterroot = Tk()root.withdraw()# Make folder picker dialog appear on top of other windowsroot.wm_attributes('-topmost', 1)def path_set(label_name: str, segment_name: str, note: str = '', init_path: str = '') -> str:        '''        label_name: 标题,用来分割不同的地址获取        segment_name: 标记,作为 session_state 的 key 以及 streamlit 组件的 key 的生成        note: 一些提示,写在地址选择上面        init_path: 初始路径,传入保存在本地的路径或其它        '''        # 会话保证刷新网页后不会丢失    if segment_name not in st.session_state:      st.session_state = init_path        # 选择路径提示    st.markdown('##### ' + label_name)    # 其它文本    st.write(note)      dirname_selected = None    col1, col2 = st.columns()    empty_text = col1.empty()    empty_text.text_input(      label='1',         value=st.session_state,         label_visibility='collapsed',         autocomplete='on',      key=segment_name + 'input' + 'a',    )    choice = col2.button('浏览文件', key=segment_name + 'button' + 'a')    if choice:      dirname_selected = filedialog.askdirectory(master=root)    if dirname_selected:      st.session_state = dirname_selected    empty_text.text_input(      label='2',         value=st.session_state,         label_visibility='collapsed',         autocomplete='on',      key=segment_name + 'input' + 'b',    )    # st.write(st.session_state) # 测试时候用的,用来观察是否成功记录思路就是用 st.columns 将页面分两栏,然后使用 st.empty 来占位,将传入的 init_path 保存在 st.session_state 的字典中用来保证刷新后不会丢失,先创建一个 st.text_input来显示初始的 init_path ,然后通过 filedialog.askdirectory 获取到文件地址后,更新 st.empty,使得输入来显示选择的地址。
这个东西花了我很长时间,主要是不太理解 Streamlit 的运作模式,又到处找能用的代码
Streamlit运行

Streamlit 的运行比较反常,不是通过 Python 而是通过 Python 环境中的 Streamlit 命令进行的,很多时候运行和调试起来很麻烦(VSCode上),下面是几种运行方式
VSCode 调试

在项目文件夹下的 .vscode 文件夹,里面的 launch.json 文件中加入
{    // 使用 IntelliSense 了解相关属性。   // 悬停以查看现有属性的描述。    // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387    "version": "0.2.0",    "configurations": [      {            "name": "Streamlit",            "type": "debugpy",            "request": "launch",            "module": "streamlit.web.cli",            "env": {                "STREAMLIT_ENABLE_COLAB_BACKEND": "true"            },            "args": [                "run",                "${file}",                "--server.port", "667",                "--server.address", "127.0.0.1"            ]      }    ]}这样使用 CodeRunner 中的调试和直接按 F5 调试就可以直接启动了
另附,虽然 Streamlit 有点麻烦,不过正常调试还是可以调试的,打上断点之后启动调试就会卡住,或是随便在代码里加入一个无关紧要的空格(随便改改,不影响代码就行)后,点页面右上角的 Rerun就OK(没有的话就在那三个点里)
通过 Python 直接运行

其实就是通过 Python 来执行命令
import streamlit.web.cli as stcliimport os, sysif __name__ == "__main__":    if getattr(sys, 'frozen', False):      current_dir = sys._MEIPASS    else:      current_dir = os.path.dirname(os.path.abspath(__file__))    file_path = os.path.join(current_dir, "main.py")    sys.argv = ["streamlit", "run", file_path,         "--server.enableCORS=true", "--server.enableXsrfProtection=false",         "--global.developmentMode=false", "--client.toolbarMode=minimal"]    sys.exit(stcli.main())注:这种是在 Python 环境中的命令,如果 Python 环境没有激活,也可以使用 Python.exe -m streamlit run <streamlit文件> 的形式来运行,例如:
可以把这个写成批处理脚本,例如:
.\runtime\python.exe -m streamlit run .\src\main.py关于图表(主要是柱状图)

Streamlit 提供的 图表 可拓展的能力实在是太低,需要做一些精细化调整时就会出现问题(不过要求不太多的话还是很好使的,也很美观),如:

[*]标签输出不能修改
[*]不能取消柱状图表鼠标滚轮缩放
[*]不能取消某个坐标轴的显示
[*]会乱序
等等,不过毕竟是封装好的简单易用的功能,如果可以忍受瑕疵的话就不要使用第三方的组件(会出现一些奇怪的问题,后面会介绍)所以为了使用更加精细的表格生成,可以通过第三方组件引入 Apache EChart ,其中有两个(在官网上发布的):

[*]ECharts:streamlit-echarts
[*]Raw ECarts:streamlit-raw-echarts
它们本身功能类似,参考链接里的写法,其中配置项 option 的配置方法参考ECharts配置项手册。
注:由于在 Python 中,option 表现为一个字典,且 Python 内是没有对应的变量,所以要将 key 写为字符串形式,value 同理,除去传入的数据,布尔类型,数字,基本上剩下的都是字符串形式
它们的不同之处在一些更加细节的地方:
参数可不可以为 JavaScript 函数

它们都包含一个 JScode 函数,可以通过库来导入,但是这个函数在 streamlit-echart 中用处就不大(可能,至少我在尝试使用的时候只能报错),而在 streamlit-raw-echart 中是可以使用的,这个函数可以帮助部分配置项配置 JavaScript函数 ,如:
options = {        "tooltip": {                "show": True,                "trigger": "item",                "showContent": True,                "triggerOn": "mousemove",                "formatter": JsCode('''function(params){return params.name+'<br>抽数:'+ params.data.value +'<br>时间:'+ params.data.time}''')        },}其中 "formatter" 就对应了一个函数,用来为悬停提示加入部分数据,这种操作在 streamlit-echart 中就只会报错:
MarshallComponentException: ('Could not convert component args to JSON', TypeError('Object of type JsCode is not JSON serializable'))大概意思就是说 JsCode 类不能被 Json 序列化
参数名字不同

切记注意两个库中函数名同样是 st_echarts 的两个函数,其中的参数名却不一样

[*]streamlit-echarts:options
[*]streamlit-raw-echarts:option
页: [1]
查看完整版本: 关于我在使用Steamlit中碰到的问题及解决方案总结