如何消除Plotly堆叠条形图上下边距，实现正常圆角效果？

核心问题排查 #

Plotly默认的自动布局机制、容器CSS样式、图表元素溢出都可能导致看似无法消除的边距，需要从布局配置和容器样式两方面入手解决。

分步解决方案 #

1. 强制关闭自动边距并清零所有边距参数 #

在布局设置中，不仅要把margin的四个方向（上t、下b、左l、右r）和内边距pad设为0，还要关闭automargin——这个参数默认会根据图表元素自动调整边距，是隐形边距的常见来源：

fig.update_layout(
    margin=dict(t=0, b=0, l=0, r=0, pad=0),
    automargin=False
)

2. 完全隐藏所有非必要图表元素 #

除了隐藏坐标轴，还要关闭网格线、刻度、零线，同时设置背景透明，避免这些元素占用额外空间：

fig.update_layout(
    plot_bgcolor='rgba(0,0,0,0)',
    paper_bgcolor='rgba(0,0,0,0)',
    xaxis=dict(showgrid=False, showticklabels=False, zeroline=False, visible=False),
    yaxis=dict(showgrid=False, showticklabels=False, zeroline=False, visible=False),
    showlegend=False  # 不需要图例则关闭
)

3. 精确控制图表尺寸 #

根据条形数量和高度手动设置height和width，避免Plotly自动计算时预留多余空间：

fig.update_layout(
    height=150,  # 示例值，根据实际条形数量调整
    width=400
)

4. 覆盖容器默认CSS样式 #

Plotly生成的图表会被包裹在一个<div>中，浏览器默认样式或Plotly内置CSS可能给这个容器添加了padding/margin，需要强制覆盖：

• 如果生成HTML文件，导出时给容器添加内联样式：

html_content = fig.to_html(full_html=False)
html_content = html_content.replace('<div ', '<div style="padding: 0 !important; margin: 0 !important; line-height: 0; overflow: hidden;" ')

• 如果嵌入现有网页，给父容器添加CSS：

.plotly-container {
    padding: 0 !important;
    margin: 0 !important;
    line-height: 0;
    overflow: hidden;
}

5. 避免元素溢出导致的边距 #

如果条形上有文本标签，可能会溢出导致Plotly自动预留空间，需要限制文本大小或隐藏溢出：

fig.update_traces(
    textposition='inside',
    uniformtext_minsize=8,
    uniformtext_mode='hide'
)

完整示例代码 #

import plotly.graph_objects as go

# 示例数据
categories = ['A', 'B', 'C']
values1 = [30, 20, 50]
values2 = [20, 30, 40]

fig = go.Figure()
fig.add_trace(go.Bar(
    y=categories,
    x=values1,
    orientation='h',
    name='Series 1',
    textposition='inside'
))
fig.add_trace(go.Bar(
    y=categories,
    x=values2,
    orientation='h',
    name='Series 2',
    textposition='inside'
))

# 整合所有布局设置
fig.update_layout(
    margin=dict(t=0, b=0, l=0, r=0, pad=0),
    automargin=False,
    plot_bgcolor='rgba(0,0,0,0)',
    paper_bgcolor='rgba(0,0,0,0)',
    xaxis=dict(showgrid=False, showticklabels=False, zeroline=False, visible=False),
    yaxis=dict(showgrid=False, showticklabels=False, zeroline=False, visible=False),
    showlegend=False,
    height=150,
    width=400
)

# 限制文本避免溢出
fig.update_traces(uniformtext_minsize=8, uniformtext_mode='hide')

# 生成带自定义样式的HTML
html_content = fig.to_html(full_html=False)
html_content = html_content.replace('<div ', '<div style="padding: 0 !important; margin: 0 !important; line-height: 0; overflow: hidden;" ')

with open('stacked_bar_no_margin.html', 'w') as f:
    f.write(html_content)

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