Streamlit导航菜单终极指南：5分钟快速上手完整教程

2026-02-06 05:48:57作者：吴年前Myrtle

Streamlit导航菜单是构建专业数据应用的关键组件，它能为用户提供清晰的功能分区和流畅的页面切换体验。本指南将带你从基础概念到高级应用，全面掌握Streamlit导航菜单的使用技巧。

为什么需要Streamlit导航菜单？

当你的Streamlit应用包含多个功能模块时，用户需要在不同页面间快速切换。传统的Streamlit侧边栏虽然简单易用，但在复杂场景下缺乏灵活性和美观度。streamlit-option-menu组件应运而生，它提供了更加优雅和功能丰富的导航解决方案。

3分钟快速安装配置

安装方法

pip install streamlit-option-menu

基础配置

import streamlit as st
from streamlit_option_menu import option_menu

# 在侧边栏创建导航菜单
with st.sidebar:
    selected = option_menu(
        "主菜单",
        ["首页", "数据分析", "设置"],
        icons=['house', 'bar-chart', 'gear'],
        default_index=0
    )

# 根据选择显示不同内容
if selected == "首页":
    st.title("欢迎来到首页")
elif selected == "数据分析":
    st.title("数据分析面板")
else:
    st.title("系统设置")

实战应用：打造专业数据仪表盘

上图展示了一个典型的水平导航菜单设计，包含首页、上传、任务和设置四个主要功能模块。这种设计非常适合数据分析和可视化应用。

完整示例代码

import streamlit as st
import pandas as pd
import plotly.express as px
from streamlit_option_menu import option_menu

# 配置页面
st.set_page_config(page_title="数据分析平台", layout="wide")

# 创建导航菜单
with st.sidebar:
    selected = option_menu(
        "功能导航",
        ["数据概览", "图表分析", "数据上传", "系统设置"],
        icons=['speedometer2', 'graph-up', 'cloud-upload', 'gear'],
        menu_icon="cast",
        default_index=0,
        styles={
            "container": {"padding": "5px", "background-color": "#f0f2f6"},
            "icon": {"color": "orange", "font-size": "18px"},
            "nav-link": {"font-size": "16px", "text-align": "left", "margin":"0px"},
            "nav-link-selected": {"background-color": "#2E86AB"},
        }
    )

# 根据选择渲染不同页面
if selected == "数据概览":
    col1, col2 = st.columns(2)
    with col1:
        st.metric("用户总数", "1,234", "+12%")
    with col2:
        st.metric("活跃用户", "890", "+8%")

elif selected == "图表分析":
    # 创建示例数据
    df = pd.DataFrame({
        '月份': ['1月', '2月', '3月', '4月', '5月', '6月'],
        '销售额': [120, 150, 180, 90, 210, 190]
    })
    
    fig = px.line(df, x='月份', y='销售额', title="月度销售趋势")
    st.plotly_chart(fig, use_container_width=True)

elif selected == "数据上传":
    uploaded_file = st.file_uploader("选择CSV文件", type=['csv'])
    if uploaded_file is not None:
        data = pd.read_csv(uploaded_file)
        st.write("数据预览：")
        st.dataframe(data.head())

else:
    st.header("系统配置")
    st.text_input("应用名称", value="数据分析平台")
    st.slider("数据刷新频率", 1, 60, 5)

垂直导航菜单更适合功能模块较多的应用，它能充分利用侧边栏空间，提供清晰的层级结构。

高级配置技巧

自定义样式配置

streamlit-option-menu支持深度自定义，你可以通过styles参数调整菜单的外观：

styles = {
    "container": {"padding": "5px", "background-color": "#f8f9fa"},
    "icon": {"color": "#6c757d", "font-size": "16px"},
    "nav-link": {
        "font-size": "14px", 
        "text-align": "left", 
        "margin": "0px",
        "border-radius": "5px"
    },
    "nav-link-selected": {
        "background-color": "#007bff",
        "color": "white",
        "font-weight": "bold"
    }
}

响应式布局优化

# 根据屏幕宽度调整布局
if st.session_state.get('screen_width', 0) > 768:
    # 大屏幕使用水平导航
    selected = option_menu(
        None,
        ["首页", "分析", "设置"],
        icons=['house', 'bar-chart', 'gear'],
        default_index=0,
        orientation="horizontal"
)
else:
    # 小屏幕使用垂直导航
    selected = option_menu(
        "菜单",
        ["首页", "分析", "设置"],
        icons=['house', 'bar-chart', 'gear'],
        default_index=0
    )

常见问题与解决方案

问题1：菜单项点击无响应

原因：未正确处理selected变量的返回值 解决方案：

selected = option_menu(...)
if selected == "首页":
    # 首页逻辑
elif selected == "分析":
    # 分析逻辑

问题2：样式不生效

原因：styles参数格式错误 解决方案：确保styles参数为字典格式，包含所有必要的键

进阶应用场景

多级嵌套菜单

对于复杂的应用，你可以实现多级菜单结构：

# 一级菜单
with st.sidebar:
    main_selected = option_menu("主分类", ["数据管理", "系统管理"])

if main_selected == "数据管理":
    # 二级菜单
    with st.sidebar:
        data_selected = option_menu(
            "数据操作",
            ["数据导入", "数据清洗", "数据分析"],
            icons=['upload', 'filter', 'bar-chart']
        )

动态菜单更新

根据应用状态动态更新菜单项：

# 根据用户权限动态显示菜单
if user_role == "admin":
    menu_items = ["仪表盘", "用户管理", "系统设置", "日志查看"]
else:
    menu_items = ["仪表盘", "个人设置"]

selected = option_menu("菜单", menu_items)