Python设置Excel字体颜色教程

本文详细介绍了使用 Python 的 openpyxl 库修改 Excel 字体颜色的方法，重点讲解了如何解决 `ValueError: Colors must be aRGB hex values` 错误。该错误通常在使用 Font 对象的 color 属性时出现，原因在于 openpyxl 对颜色格式有严格要求，需要 ARGB 十六进制值。文章阐述了 openpyxl 中颜色表示的正确方式，并提供了实用解决方案，即通过提取预定义颜色对象的 ARGB 十六进制值来创建 Font 颜色，或者直接使用十六进制颜色字符串。通过本文，读者可以学会如何避免颜色格式错误，确保 Excel 字体颜色设置的准确性和兼容性，从而创建专业美观的 Excel 报告。

本文详细介绍了如何使用 Python 的 openpyxl 库在 Excel 文件中设置单元格字体颜色，特别是针对 Font 对象的 color 属性引发的 ValueError: Colors must be aRGB hex values 错误。文章解释了 openpyxl 中颜色表示的正确方式，并提供了通过提取预定义颜色对象的 ARGB 十六进制值来创建 Font 颜色的解决方案，确保颜色设置的准确性和兼容性。

1. openpyxl 库简介与 Excel 样式操作

openpyxl 是一个功能强大的 Python 库，用于读取、写入和修改 .xlsx 格式的 Excel 文件。它提供了丰富的 API 来操作工作簿、工作表、单元格以及各种样式属性，包括字体、填充、边框等。

在 openpyxl 中，单元格的样式可以通过 openpyxl.styles 模块进行控制。其中，Font 类用于定义字体样式，如字体名称、大小、粗细、斜体以及颜色。PatternFill 类用于定义单元格的背景填充。

2. 理解 Font 对象的颜色属性与常见错误

在使用 openpyxl 设置单元格字体颜色时，我们通常会用到 Font 类的 color 属性。例如，尝试将字体颜色设置为白色：

from openpyxl.styles import Font, colors

# ... 其他代码 ...
cell.font = Font(color=colors.WHITE, bold=True)
# ...

然而，上述代码在某些 openpyxl 版本或特定环境下可能会抛出 ValueError: Colors must be aRGB hex values 错误。这个错误明确指出，Font 对象的 color 属性期望接收一个 ARGB（Alpha, Red, Green, Blue）格式的十六进制颜色字符串，或者一个内部能够正确解析为 ARGB 十六进制值的 Color 对象。

虽然 openpyxl.styles.colors.WHITE 是一个预定义的 Color 对象，但直接将其作为 Font 的 color 参数传递时，可能未能正确地被 Font 构造函数解析为所需的 ARGB 十六进制格式。

3. 解决方案：确保颜色格式为 ARGB 十六进制

解决 ValueError 的关键在于确保传递给 Font(color=...) 的值是一个明确的 ARGB 十六进制颜色表示。openpyxl 的 Color 对象提供了 get_hex_color() 方法，可以获取其对应的 ARGB 十六进制字符串。我们可以利用这一点来构造正确的 Color 对象，或者直接使用十六进制字符串。

最稳健的解决方案是，从预定义的 colors 对象中提取其 ARGB 十六进制值，然后用这个值来构造一个新的 Color 对象，并将其传递给 Font。

修正后的代码示例：

import openpyxl
from openpyxl import Workbook
from openpyxl.styles import Color, PatternFill, Font, Border
from openpyxl.styles import colors

# 假设文件 'file.xlsx' 存在
# 如果文件不存在，可以先创建一个空的 workbook
try:
    wb = openpyxl.load_workbook('file.xlsx', read_only=False)
except FileNotFoundError:
    print("文件 'file.xlsx' 不存在，将创建一个新的工作簿。")
    wb = Workbook()
    # 确保至少有一个 sheet，例如 sheet1
    if 'Sheet' not in wb.sheetnames:
        wb.create_sheet('Sheet') # openpyxl 默认会创建 'Sheet'
    wb.save('file.xlsx')
    wb = openpyxl.load_workbook('file.xlsx', read_only=False) # 重新加载以确保所有默认sheet都已加载

keep_sheets = ['sheet3','sheet2','sheet1'] # 示例中的 sheet 名称

# 确保示例中的 sheet 存在，如果不存在则创建
for sheet_name in keep_sheets:
    if sheet_name not in wb.sheetnames:
        wb.create_sheet(sheet_name)

print("当前工作表名称:", wb.sheetnames)

for sheetName in wb.sheetnames:
    if sheetName in keep_sheets:
        ws = wb[sheetName]
        print(f"正在处理工作表: {ws.title}")

        # 定义填充样式
        fill_pattern = PatternFill(start_color='4F81BD', # 注意：十六进制颜色值不需要 # 前缀
                                   end_color='4F81BD',
                                   fill_type='solid')

        # 遍历第一行（假设处理前10列）
        # range(1, 11) 对应 A 到 J 列
        for col_idx in range(1, 11):
            cell = ws.cell(row=1, column=col_idx)
            cell.fill = fill_pattern

            # 修正字体颜色设置：
            # 从 colors.WHITE 获取 ARGB 十六进制值，然后用它来创建新的 Color 对象
            cell.font = Font(color=Color(colors.WHITE.get_hex_color()), bold=True)
            # 或者更简洁地直接使用十六进制字符串 (例如 'FFFFFFFF' 代表白色)
            # cell.font = Font(color='FFFFFFFF', bold=True)
            # 或者使用 colors.WHITE.rgb
            # cell.font = Font(color=colors.WHITE.rgb, bold=True)

            # 示例：为单元格写入内容
            cell.value = f"Header {col_idx}"


# 保存更改到新文件
output_filename = 'updated_file.xlsx'
wb.save(output_filename)
print(f"文件已成功保存为: {output_filename}")

解释修正：

1. Color(colors.WHITE.get_hex_color()): 这是解决问题的核心。colors.WHITE 本身是一个 Color 对象，通过调用其 get_hex_color() 方法，我们可以获取到代表白色的 ARGB 十六进制字符串（例如 'FFFFFFFF'）。然后，我们使用这个十六进制字符串作为参数，重新构造一个新的 Color 对象。这种方式确保了 Font 对象的 color 属性接收到一个明确且符合其内部要求的 Color 实例。
2. 十六进制颜色值格式: openpyxl 期望的十六进制颜色值是 8 位 ARGB 格式（例如，'FFFFFFFF' 代表不透明的白色，'FF000000' 代表不透明的黑色）。在 PatternFill 中，通常使用 6 位 RGB 格式（例如 '4F81BD'），但 Font 的 color 属性通常更严格地要求 ARGB。
3. PatternFill 的颜色: 注意 PatternFill 的 start_color 和 end_color 属性通常接受 6 位 RGB 十六进制字符串，不需要 # 前缀。如果需要透明度，则需要 8 位 ARGB。

4. 注意事项与最佳实践

• 颜色格式一致性: 始终注意 openpyxl 中不同样式属性对颜色格式的要求。Font 的 color 属性通常更偏向于 ARGB 十六进制或通过 ARGB 十六进制构建的 Color 对象。
• 预定义颜色: openpyxl.styles.colors 模块提供了许多预定义的颜色常量（如 colors.BLACK, colors.RED, colors.BLUE 等）。在设置字体颜色时，如果遇到 ValueError，请尝试使用 Color(预定义颜色.get_hex_color()) 的模式。
• 自定义颜色: 如果需要使用自定义颜色，可以直接提供 8 位 ARGB 十六进制字符串给 Font(color='AARRGGBB')，或者使用 Color('AARRGGBB') 构造 Color 对象。
• 性能考量: 大规模修改单元格样式时，考虑性能。openpyxl 在写入大量数据和样式时可能会消耗较多内存和时间。
• 错误处理: 在加载或保存 Excel 文件时，建议添加 try-except 块来处理 FileNotFoundError 等潜在错误。

通过遵循上述指导和示例代码，您可以有效地使用 openpyxl 库来控制 Excel 单元格的字体颜色，避免常见的颜色格式错误，并创建专业且美观的 Excel 报告。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python设置Excel字体颜色教程》文章吧，也可关注golang学习网公众号了解相关技术文章。