使用openpyxl的CellIsRule设置条件格式时丢失引号致文件损坏

当用openpyxl设置值为"R"的条件格式时，核心问题是Excel要求字符串匹配的公式必须带双引号，而直接传递'R'作为公式内容会被openpyxl解析为无引号的公式，导致Excel报错。

正确实现代码 #

from openpyxl import Workbook
from openpyxl.styles import PatternFill, Font
from openpyxl.formatting.rule import CellIsRule

# 初始化工作簿和工作表
wb = Workbook()
ws = wb.active

# 定义格式：浅红填充+深红文本
fill = PatternFill(start_color="FFC7CE", end_color="FFC7CE", fill_type="solid")
font = Font(color="9C0006")

# 关键：公式中用双引号包裹目标字符串，Python中用单引号包裹整个公式避免转义
ws.conditional_formatting.add(
    'A1:C10',  # 应用条件格式的单元格区域
    CellIsRule(
        operator='equal',
        formula=['="R"'],  # 这里必须写成带双引号的公式
        fill=fill,
        font=font
    )
)

wb.save('formatted_excel.xlsx')

原理说明 #

Excel的条件格式中，匹配固定字符串需要在公式里用双引号标记（比如="R"），openpyxl不会自动为字符串添加引号，必须手动在formula参数中指定完整的带引号公式。如果直接传['R']，生成的XML中<formula>标签内容就是R，Excel会将其视为单元格引用而非字符串，从而触发格式错误。

另一种实现方式（用FormulaRule） #

如果需要更灵活的公式控制，也可以直接使用FormulaRule：

from openpyxl.formatting.rule import FormulaRule

ws.conditional_formatting.add(
    'A1:C10',
    FormulaRule(
        formula=['A1="R"'],  # 这里的单元格引用要和应用区域对应
        fill=fill,
        font=font
    )
)

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