使用openpyxl设置DataBarRule时，0%与100%数据条显示异常

我在给Excel工作表添加DataBarRule时，代码能正常运行，但Excel里显示异常：设置数据条类型为百分比后，0%时数据条没有消失，100%时也没填满整个单元格，只有50%的显示是正常的。

数据条显示效果：0%单元格仍有短数据条，100%单元格数据条未填满，仅50%单元格数据条长度正常。

代码 #

import openpyxl
from openpyxl.formatting.rule import DataBarRule


wb = openpyxl.load_workbook("./test.xlsm", keep_vba=True)
ws = wb["Overview"]

rule = DataBarRule(
    start_type="percent",
    start_value=0,
    end_type="percent",
    end_value=100,
    color="000000",
    showValue=None,
    minLength=None,
    maxLength=None,
)

ws.conditional_formatting.add("A1:A3", rule)

wb.save("./test.xlsm")

复现步骤 #

• 创建名为test.xlsm的Excel文件
• 创建名为Overview的工作表
• 在单元格A1:A3中输入值0、0.5、1，并设置数字格式为百分比
• 运行上述代码

问题原因 #

出现异常的核心原因有两点：

1. openpyxl默认给minLength和maxLength设置了非0/100的数值，Excel会基于这两个参数给数据条保留最小、最大长度限制，导致0%不消失、100%不满格。
2. 单元格实际存储的是小数（0、0.5、1），用start_type="percent"会和Excel的数值匹配逻辑错位，进一步加剧显示异常。

修正后的代码 #

import openpyxl
from openpyxl.formatting.rule import DataBarRule


wb = openpyxl.load_workbook("./test.xlsm", keep_vba=True)
ws = wb["Overview"]

rule = DataBarRule(
    start_type="num",  # 匹配单元格实际存储的小数数值
    start_value=0,
    end_type="num",
    end_value=1,
    color="000000",
    showValue=None,
    minLength=0,  # 强制0值对应数据条长度为0
    maxLength=100,  # 强制1值对应数据条填满单元格
)

ws.conditional_formatting.add("A1:A3", rule)

wb.save("./test.xlsm")

补充说明 #

如果一定要保留percent类型规则，可修改参数如下（需确保单元格数值和百分比显示严格对应：0→0%、1→100%）：

rule = DataBarRule(
    start_type="percent",
    start_value=0,
    end_type="percent",
    end_value=100,
    color="000000",
    showValue=None,
    minLength=0,
    maxLength=100,
)

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