Plotly多子图中如何兼顾自定义标记与x轴原始刻度值显示并优化性能

针对你用Plotly创建多子图时遇到的问题，这里提供几个高效且能满足需求的方案：

方案1：批量添加垂直线+标注（保留原始刻度） #

fig.add_vline性能差的核心原因是它会为每个子图单独创建元素，15个子图重复操作导致耗时激增。改用fig.add_shape批量添加垂直线，搭配annotations做标签，性能会大幅提升，同时保留原始x轴刻度：

import plotly.subplots as sp
import plotly.graph_objects as go

# 创建15个子图（按5行3列排布，共享x轴）
fig = sp.make_subplots(rows=5, cols=3, shared_xaxes=True)

# 模拟填充数据
x = list(range(100))
for idx in range(15):
    row = (idx // 3) + 1
    col = (idx % 3) + 1
    fig.add_trace(go.Scatter(x=x, y=[i+(idx*5) for i in x]), row=row, col=col)

# 定义需要标记的重要x点位
important_x = [20, 50, 80]
line_style = dict(color="#00cc00", dash="dash")

# 批量给所有子图添加垂直线
for x_val in important_x:
    fig.add_shape(
        type="line",
        x0=x_val, y0=0, x1=x_val, y1=1,
        xref="x", yref="paper",  # yref="paper"表示基于子图高度的比例（0-1）
        line=line_style,
        row="all", col="all"  # 应用到所有子图
    )

# 添加重要点位的标签（放在子图顶部）
for x_val in important_x:
    fig.add_annotation(
        x=x_val, y=1.05,
        xref="x", yref="paper",
        text=f"关键点位: {x_val}",
        showarrow=False,
        font=dict(color="#00cc00", size=10)
    )

# 确保显示原始x轴刻度
fig.update_xaxes(showticklabels=True)
fig.show()

这个方案的耗时和update_xaxes接近，同时能保留原始刻度，视觉上也清晰区分了重要点位。

方案2：合并原始刻度与自定义标记（高性能） #

如果你不需要垂直线，只想突出显示重要点位的刻度，直接合并原始自动生成的刻度和自定义点位，用富文本格式区分样式：

# 先获取自动生成的x轴刻度（以第一个子图的x轴为例）
default_ticks = list(fig.layout.xaxis.tickvals)
# 合并并去重、排序刻度值
combined_ticks = sorted(list(set(default_ticks + important_x)))
# 生成对应刻度文本，重要点位用绿色加粗
tick_texts = []
for val in combined_ticks:
    if val in important_x:
        tick_texts.append(f"<span style='color:#00cc00; font-weight:bold'>{val}</span>")
    else:
        tick_texts.append(str(val))

# 更新所有x轴
fig.update_xaxes(
    tickmode="array",
    tickvals=combined_ticks,
    ticktext=tick_texts,
    gridcolor="#00cc00",
    griddash="dash",
    gridwidth=1
)
fig.show()

这个方案完全复用了update_xaxes的高性能，同时兼顾了原始刻度和重要点位的标注，是最推荐的方案。

方案3：修复次要刻度显示（针对你的尝试） #

如果你坚持要用次要刻度显示原始数值，可能是之前的配置有误。需要明确设置次要刻度的显示规则，注意共享x轴的场景下要统一配置：

fig.update_xaxes(
    # 主刻度显示重要点位
    tickmode="array",
    tickvals=important_x,
    ticktext=[f"关键点位 {x}" for x in important_x],
    tickfont=dict(color="#00cc00"),
    # 次要刻度显示原始数值
    showsecondaryticklabels=True,
    secondarytickmode="auto",
    secondarytickfont=dict(color="#333333"),
    # 保留绿色虚线网格
    gridcolor="#00cc00",
    griddash="dash"
)

注：部分Plotly版本对次要刻度的支持在共享x轴场景下可能存在兼容性问题，优先推荐前两个方案。

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