在Plotly的数据可视化开发中，循环添加轨迹是批量处理多组数据的常见操作，此时自定义每个轨迹的图例名称能让图表信息更清晰，避免默认名称带来的理解障碍。
核心原理说明
Plotly中每个轨迹的图例名称由轨迹对象的name属性控制，在循环添加轨迹时，只需要在每次创建轨迹对象时，为name属性赋值对应的自定义名称即可，该属性支持直接传入字符串，也支持结合循环变量动态生成名称。
基础实现示例
以下示例通过循环添加3条折线轨迹，每条轨迹的图例名称自定义为对应数据组的标识：
import plotly.graph_objects as go
# 初始化图表对象
fig = go.Figure()
# 模拟3组数据
data_groups = [
{"x": [1, 2, 3], "y": [2, 5, 3], "name": "第一组"},
{"x": [1, 2, 3], "y": [3, 1, 6], "name": "第二组"},
{"x": [1, 2, 3], "y": [4, 2, 7], "name": "第三组"}
]
# 循环添加轨迹并自定义图例名称
for group in data_groups:
fig.add_trace(
go.Scatter(
x=group["x"],
y=group["y"],
name=group["name"], # 设置当前轨迹的图例名称
mode="lines+markers"
)
)
# 显示图表
fig.show()
动态生成图例名称
如果图例名称需要结合循环索引或者外部变量动态生成，可以直接在name属性中拼接字符串，示例如下：
import plotly.graph_objects as go
fig = go.Figure()
base_name = "实验数据"
for i in range(1, 4):
fig.add_trace(
go.Scatter(
x=[1, 2, 3],
y=[i*2, i*3, i*4],
name=f"{base_name}_第{i}次", # 动态拼接图例名称
mode="lines"
)
)
fig.show()
常见错误与解决
错误1：设置全局名称属性
部分开发者会尝试在循环外设置统一的名称属性，这样会导致所有轨迹的图例名称相同，无法区分。解决方式是在循环内部为每个轨迹单独设置name属性。
错误2：名称包含特殊字符导致显示异常
如果自定义名称中包含HTML特殊字符，比如<、>、&等，需要提前进行转义，否则会导致图表渲染错误。例如名称需要包含小于号时，应该写成name="数值<10"。
注意事项
- 同一个图表中，不同轨迹的
name属性值如果重复，Plotly会自动合并图例项，若需要分开显示，需保证名称唯一。 - 如果需要隐藏某条轨迹的图例，可以设置
showlegend=False，该参数优先级高于name属性。 - 对于子图场景，自定义图例名称的逻辑和单图场景一致，只需要在对应子图的轨迹中添加
name属性即可。