使用fig.add_vline添加注释文本时出现Timestamp与整数运算不支持的TypeError错误

嘿，这个坑我之前踩过！你遇到的这个TypeError其实是Plotly的add_vline方法在处理时间轴注释时的一个小bug——当你直接在add_vline里用annotation_text参数时，它内部会尝试对时间戳做整数加减运算，而Pandas从某个版本开始已经禁止了这种操作，所以触发了这个错误。

解决方案：分开添加垂直线和注释 #

最稳妥的办法是把垂直线和注释分开处理：先用add_vline添加线条，再用add_annotation单独添加注释文本，这样就能避开时间戳运算的问题。

示例代码如下：

import pandas as pd
import plotly.graph_objects as go

# 假设你已经有了fig对象
fig = go.Figure()

# 第一步：添加垂直线（和你原来的代码一致）
fig.add_vline(
    x=pd.to_datetime('1970-01-01 00:00:00'),
    line_dash='dot',
    row=0
)

# 第二步：单独添加注释
fig.add_annotation(
    x=pd.to_datetime('1970-01-01 00:00:00'),
    # 这里可以设置y轴位置，比如取y轴最大值，或者固定数值
    y=fig.layout.yaxis.range[1] if fig.layout.yaxis.range else 1,
    text='15',
    showarrow=False,
    xanchor='left',  # 让文本靠左对齐垂直线
    yanchor='top',   # 让文本在垂直线顶部
    row=0  # 和垂直线对应同一行
)

fig.show()

为什么这个方法有效？ #

add_annotation是直接基于时间戳定位注释位置，不会像add_vline的内置注释功能那样，错误地对时间戳执行整数加减操作，完美避开了Pandas的限制。你还可以通过调整xanchor、yanchor、y等参数，精准控制注释的显示位置，比直接用add_vline的annotation参数更灵活。

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