Plotly折线图如何在不更改图表类型时修改图例项形状为方框或圆形

该调整完全不需要修改原有折线图的渲染逻辑、不改变折线本身的展示效果，仅通过配置即可实现图例从默认短线条切换为方框、圆形等自定义形状，兼容原有纯折线的图表类型。

核心实现原理 #

默认纯折线模式下，图例的渲染内容是对应系列的短色条。要替换成自定义形状，只需要在对应折线trace上补充marker属性配置——由于我们保持mode='lines'的纯折线模式，配置的marker不会在实际折线的数据点上渲染，仅会作为图例的展示符号使用，完全不影响原有图表形态。

具体配置步骤 #

• 选择需要的图例形状：Plotly支持的可自定义图例符号包括circle（圆形）、square（正方形）、diamond（菱形）、triangle-up（上三角）、x（叉形）、cross（十字形）等，可直接通过marker.symbol属性指定
• 调整形状视觉效果：可通过marker.size设置符号大小，通过marker.line给符号加对比色描边（比如白色细边），提升图例和整体图表的视觉协调性
• 统一图例展示规则：在全局布局配置中设置legend.itemsizing='constant'，固定所有图例符号的尺寸，避免不同系列的线条宽度变化导致图例符号大小不一致

参考实现代码 #

import plotly.graph_objects as go

fig = go.Figure()
# 第一组折线：图例用带白边的正方形
fig.add_trace(go.Scatter(
    x=[1, 2, 3], y=[2, 5, 3],
    mode='lines', # 保持纯折线模式，不改变原有图表类型
    line=dict(color='#2563eb', width=2),
    marker=dict(
        symbol='square',
        size=12,
        line=dict(color='white', width=1)
    ),
    name='产品A'
))
# 第二组折线：图例用带白边的圆形
fig.add_trace(go.Scatter(
    x=[1, 2, 3], y=[3, 4, 5],
    mode='lines',
    line=dict(color='#f97316', width=2),
    marker=dict(
        symbol='circle',
        size=12,
        line=dict(color='white', width=1)
    ),
    name='产品B'
))

# 全局图例配置
fig.update_layout(
    legend=dict(
        itemsizing='constant',
        orientation='v'
    )
)
fig.show()

常见避坑提示 #

• 不要随意修改mode为lines+markers，该操作会让配置的形状直接渲染在折线的所有数据点上，破坏原有纯折线的展示效果
• 如果是通过Plotly Express快速生成的折线图，无需重新编写生成逻辑，直接遍历fig.data数组给每个trace补加对应的marker配置即可完成替换

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