本文详解如何在 Plotly 中正确配置第二个图例（legend2）的外观与位置，指出直接使用 legend2_font 等“下划线语法”会失效的原因，并提供可立即运行的解决方案。
本文详解如何在 plotly 中正确配置第二个图例（legend2）的外观与位置，指出直接使用 `legend2_font` 等“下划线语法”会失效的原因，并提供可立即运行的解决方案。
在 Plotly 中，当通过 add_scatter(..., legend="legend2") 显式指定图例组时，系统并不会自动创建 layout.legend2 对象——这与 xaxis2 或 yaxis2 的行为不同（后者在首次引用时会被自动初始化）。因此，若尝试使用 legend2_font_size=20 这类“魔法下划线”快捷语法，Plotly 将忽略该设置，因为 legend2 本身尚未作为 layout 的键存在。
✅ 正确做法是：显式将 legend2 声明为字典对象，并在其中使用标准属性名（支持下划线快捷写法，如 font_size、y、x、orientation 等）：
import plotly.express as px
import pandas as pd
numbers = pd.DataFrame([[1,2,3,4], [2,3,4,5], [5,7,8,8]])
fig = px.line(numbers, markers=True)
# 添加第二组数据并绑定到 legend2
fig = fig.add_scatter(
x=[4, 3],
y=[1, 2],
mode='markers+lines',
name='Secondary Series',
legendgroup='legend2', # 推荐显式设置 legendgroup（更健壮）
showlegend=True,
legend='legend2' # 显式指定图例归属
)
# ✅ 正确更新 legend2 样式：必须以 dict 形式传入
fig.update_layout(
legend_font_size=16, # 主图例字体大小
legend2=dict(
font_size=20, # 第二图例字体大小
y=0.8, # 垂直位置（0–1，相对于绘图区顶部）
x=0.02, # 水平位置（0–1，相对于绘图区左侧）
xanchor='left',
yanchor='top',
bgcolor='rgba(255, 255, 255, 0.8)',
bordercolor='lightgray',
borderwidth=1
)
)
fig.show()
⚠️ 注意事项：
- legend="legend2" 仅用于标识图例归属，不自动创建 layout 配置项；必须配合 update_layout(legend2={...}) 才生效；
- 推荐同时设置 legendgroup='legend2' 和 showlegend=True，确保多 trace 统一归组且可见；
- legend2 支持全部 legend 的布局属性（如 orientation='h'、traceorder、itemwidth），详见 Plotly Legend Reference；
- 若需完全隐藏主图例，可加 legend=dict(y=-1) 将其移出可视区，或设 showlegend=False 在 trace 级控制。
总结：Plotly 的 legend2 是一个“按需创建”的布局组件，不能依赖隐式初始化。始终采用 legend2=dict(...) 的显式字典赋值方式，才能可靠定制其样式、位置与交互行为——这是构建多图例专业可视化图表的关键实践。
