Plotly(Python)中设置日期时间X轴边界的问题

核心问题原因 #

当使用textposition='middle right'标记最后一个数据点时，Plotly会将文本的占位范围纳入X轴的自动计算范围，导致X轴被拉长到超出实际数据的月份。解决思路是手动锁定X轴范围，或者改用annotations添加标签（不影响轴范围）。

方案一：手动锁定X轴范围（适配scatter带文本标记的场景） #

如果你的代码是通过go.Scatter的text参数添加标签，只需手动指定X轴的range为数据的实际起止日期，同时调整图表边距避免标签被截断：

import plotly.graph_objects as go
import pandas as pd

# 构造示例月度数据
dates = pd.date_range(start='2021-01-01', end='2022-12-01', freq='MS')
values = [i*2 + 10 for i in range(len(dates))]

fig = go.Figure()

# 绘制主时间序列
fig.add_trace(go.Scatter(
    x=dates,
    y=values,
    mode='lines+markers+text',
    text=[None]* (len(values)-1) + [f"期末值: {values[-1]}"],  # 仅最后一个点加标签
    textposition='middle right',
    textfont=dict(size=12)
))

# 手动设置X轴范围为数据的起止日期
fig.update_xaxes(
    type='date',
    range=[dates[0], dates[-1]],  # 锁定X轴到实际数据的时间范围
    tickformat='%Y-%m'
)

# 调整右侧边距，避免标签被截断
fig.update_layout(
    margin=dict(r=80),  # 右侧留足够空间放标签
    title='月度数据趋势（带期末标签）'
)

fig.show()

方案二：使用annotations添加标签（更灵活，不影响轴范围） #

改用Plotly的annotations功能直接标注最后一个点，这种方式不会让标签影响X轴的自动范围，还能更精准控制标签位置：

import plotly.graph_objects as go
import pandas as pd

# 构造示例月度数据
dates = pd.date_range(start='2021-01-01', end='2022-12-01', freq='MS')
values = [i*2 + 10 for i in range(len(dates))]

fig = go.Figure()

# 绘制主时间序列
fig.add_trace(go.Scatter(
    x=dates,
    y=values,
    mode='lines+markers'
))

# 添加期末标签（annotations方式）
last_x = dates[-1]
last_y = values[-1]
fig.add_annotation(
    x=last_x,
    y=last_y,
    text=f"期末值: {last_y}",
    xshift=30,  # 向右偏移30像素，避免和标记重叠
    showarrow=False,
    font=dict(size=12)
)

# X轴自动适配数据范围（无需手动锁定，因为annotations不影响轴范围）
fig.update_xaxes(
    type='date',
    tickformat='%Y-%m'
)

fig.update_layout(
    margin=dict(r=80),
    title='月度数据趋势（带期末标签）'
)

fig.show()

关键注意点 #

• 方案一中，range参数必须严格对应数据的起止日期，确保X轴不会被标签扩展；
• 两种方案都需要调整margin=dict(r=80)（右侧边距），避免标签被图表边框截断；
• 如果使用annotations，xshift可以根据标签长度调整，保证标签和数据点不重叠。

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