如何让Pandas style.background_gradient渲染HTML表格时忽略NaN？

这个问题我之前也碰到过，核心就是NaN值干扰了颜色映射的计算，同时触发了matplotlib的警告。下面给你一个完美的解决办法，既能保留NaN的语义，又能让有效值正常着色，还能消除警告：

核心思路 #

我们需要让颜色映射仅基于各列的有效值计算范围，同时给NaN值单独设置一个背景色来区分，完全避免NaN参与颜色梯度的计算：

1. 先为TIME_FRAMES中的每一列计算有效值的最小值和最大值，确保颜色映射的范围只覆盖实际存在的数据
2. 在background_gradient中传入这些极值，并指定NaN值的背景色
3. 这样既不会修改NaN的语义（不用设为0），又能消除matplotlib的警告，还能让有效值的着色完全正常

修改后的完整代码 #

import seaborn as sns
import pandas as pd

TIME_FRAMES = ["24h", "7d", "30d", "1y"]
# 假设results是你的目标DataFrame，替换成实际数据即可
# results = pd.DataFrame(...)

# Set CSS properties for th elements in dataframe
th_props = [
    ('font-size', '11px'),
    ('text-align', 'center'),
    ('font-weight', 'bold'),
    ('color', '#6d6d6d'),
    ('background-color', '#f7f7f9')
]
# Set CSS properties for td elements in dataframe
td_props = [
    ('font-size', '11px')
]
# 合并表格样式
styles = [dict(selector="th", props=th_props), dict(selector="td", props=td_props)]

cm = sns.light_palette("green", as_cmap=True)

# 关键步骤：为每个目标列计算有效值的min和max
col_ranges = {col: (results[col].dropna().min(), results[col].dropna().max()) for col in TIME_FRAMES}

# 构建样式：对每个列单独设置vmin和vmax，同时指定NaN的背景色
s = results.style
for col in TIME_FRAMES:
    vmin, vmax = col_ranges[col]
    s = s.background_gradient(cmap=cm, subset=[col], vmin=vmin, vmax=vmax, na_color="#f0f0f0")

# 应用表格样式并渲染
s = s.set_table_styles(styles)
a = s.render()

with open("test.html", "w") as f:
    f.write(a)

代码细节说明 #

• col_ranges字典：遍历每个时间列，用dropna()去掉NaN后计算该列的最小和最大值，确保颜色梯度只基于有效数据，彻底排除NaN的干扰
• na_color="#f0f0f0"：给NaN值设置浅灰色背景，你可以根据需求改成其他颜色（比如"transparent"保持透明，或者和表格背景区分开的颜色）
• 循环为每个列单独设置background_gradient：这样每个列的颜色映射范围都是独立的，更符合数据展示逻辑，也避免了跨列数据的干扰

这样运行后，你会发现：

• 之前的RuntimeWarning完全消失
• 30d和1y列的有效值会基于自身的范围正常着色
• NaN值会显示为你指定的背景色，保留了它的缺失值语义，没有被替换成0

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