Plotly柱状图自定义注释异常：整数年份导致布局错乱

问题根源 #

当x轴使用纯整数年份时，Plotly会默认将其识别为数值型轴，而非分类轴。手动添加注释时，如果注释的x坐标逻辑没适配数值轴特性，就会干扰柱子的布局计算，导致间距异常。而带后缀的字符串年份会被自动识别为分类轴，所以不会出现这个问题。

解决步骤 #

1. 强制设置x轴为分类轴 #

显式指定x轴类型为category，彻底避免Plotly自动识别为数值轴。即使年份是整数或数字字符串，也会按分类逻辑渲染：

fig.update_xaxes(type='category')

2. 手动计算柱子和注释的x坐标 #

分组柱状图的每个柱子需要基于分类轴的索引进行偏移计算，确保同一年份的多个柱子紧密排列，注释也能精准对应：

• 先定义分组偏移量（比如offset=0.2，可根据需求调整）
• 对每个分组，计算其柱子的x坐标：[idx + i*offset - (n_groups-1)*offset/2 for idx in range(len(years))]
  • idx是年份在分类列表中的索引
  • i是当前分组的索引
  • n_groups是分组总数

3. 匹配x轴刻度与原始年份 #

设置x轴的tickvals为分类索引，ticktext为原始整数年份，保证显示的还是用户需要的年份格式：

fig.update_xaxes(
    type='category',
    tickvals=[idx for idx in range(len(years))],
    ticktext=years  # years是原始整数年份列表
)

完整代码示例 #

import plotly.graph_objects as go

# 示例数据
years = [1975, 1976, 1977]
group_names = ['Group 1', 'Group 2']
group_data = {
    'Group 1': [12, 18, 25],
    'Group 2': [15, 22, 28]
}

fig = go.Figure()
offset = 0.2  # 分组柱子的间距偏移
n_groups = len(group_names)

# 添加分组柱状图
for i, group in enumerate(group_names):
    # 计算每个柱子的x坐标（基于分类索引偏移）
    x_coords = [idx + i*offset - (n_groups-1)*offset/2 for idx in range(len(years))]
    fig.add_trace(go.Bar(
        x=x_coords,
        y=group_data[group],
        name=group
    ))

# 强制x轴为分类轴，设置刻度显示原始年份
fig.update_xaxes(
    type='category',
    tickvals=list(range(len(years))),
    ticktext=years,
    title='年份'
)

# 添加自定义带箭头注释
for year_idx, year in enumerate(years):
    for group_idx, group in enumerate(group_names):
        x = year_idx + group_idx*offset - (n_groups-1)*offset/2
        y = group_data[group][year_idx] + 1.5  # 注释在柱子上方的位置
        fig.add_annotation(
            x=x,
            y=y,
            text=f'{group_data[group][year_idx]}',
            showarrow=True,
            arrowhead=2,
            ax=0,
            ay=-25,
            font={'size': 10}
        )

# 调整布局
fig.update_layout(
    barmode='group',
    title='分组柱状图自定义注释示例',
    yaxis_title='数值'
)

fig.show()

关键说明 #

• 之前直接转字符串无效的原因：Plotly会自动识别内容为数字的字符串为数值轴，必须显式设置type='category'才能强制按分类轴处理。
• 手动计算x坐标的逻辑确保了分组柱子的排列和注释定位的准确性，不会因为轴类型的变化出现布局混乱。

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