Python Plotly封装bar函数传入barmode为何报错？

报错原因 #

你在自定义to_bar函数时，调用px.bar采用了位置参数传递方式，但px.bar的参数顺序中，第四个位置参数是pattern_shape而非barmode。你把barmode='group'按位置传给了pattern_shape参数，导致Plotly误以为你要将group作为数据列设置图案形状，而你的数据框里并没有该列，因此触发ValueError。

修正方法 #

修改自定义函数内px.bar的调用逻辑，显式指定每个参数的名称，避免位置参数匹配错位：

import plotly.express as px
import pandas as pd

df_test = pd.DataFrame({
    "Fruit": ["Apples", "Oranges", "Bananas", "Apples", "Oranges", "Bananas"],
    "Amount": [4, 1, 2, 2, 4, 5],
    "City": ["SF", "SF", "SF", "Montreal", "Montreal", "Montreal"]
})

def to_bar(data,x,y,color,barmode):
    # 显式指定参数名，确保与px.bar的参数一一对应
    bar_chart = px.bar(data_frame=data, x=x, y=y, color=color, barmode=barmode)
    return bar_chart


fig_test_func = to_bar(df_test, x="Fruit", y="Amount",color='City',barmode='group')

fig_test_reg = px.bar(df_test, x="Fruit", y="Amount",color='City',barmode='group')

fig_test_func.show()

关键注意点 #

• Plotly Express函数参数数量多，直接按位置传递极易出错，尤其是非连续必填参数，必须显式指定参数名。
• 你直接调用px.bar时用的是关键字参数，参数匹配正确；但自定义函数内部用了位置传递，导致参数错位，这是问题的核心。

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