当前位置：首页 > 文章列表 > 文章 > python教程 > Excel设置字体颜色的几种方法

Excel设置字体颜色的几种方法

2025-08-21 18:24:31 0浏览收藏

想要高效设置Excel单元格字体颜色？本文以Python的openpyxl库为例，**详细讲解Excel单元格字体颜色设置方法**，并着重解决`ValueError: Colors must be aRGB hex values`报错。通过本文，你将学会使用ARGB十六进制颜色格式和`openpyxl.styles.colors.Color`对象，**轻松定制Excel单元格样式**。文章包含openpyxl库的简介、工作簿加载与工作表选择，以及单元格背景填充和字体颜色设置的实操代码，助你**快速掌握Excel样式设置技巧**，提升数据处理效率。

使用openpyxl库在Excel中设置单元格字体颜色

本文详细介绍了如何使用Python的openpyxl库在Excel文件中设置单元格的字体颜色和背景填充。重点解析了在设置字体颜色时可能遇到的ValueError: Colors must be aRGB hex values错误，并提供了通过指定正确的ARGB十六进制颜色格式或利用openpyxl.styles.colors.Color对象来解决此问题的专业方法，确保用户能够高效、准确地对Excel单元格进行样式定制。

1. openpyxl库简介与环境准备

openpyxl是一个用于读写Excel 2010 xlsx/xlsm/xltx/xltm文件的Python库。它功能强大，可以创建、修改工作簿、工作表、单元格，并设置各种样式，包括字体、颜色、边框、填充等。

在开始之前，请确保你已经安装了openpyxl库：

pip install openpyxl

2. 加载工作簿与选择工作表

要修改现有的Excel文件，首先需要加载它。如果文件不存在，openpyxl也可以用于创建新的工作簿。

import openpyxl
from openpyxl.styles import Font, PatternFill, Color # 导入必要的样式模块

# 加载现有工作簿
# 如果文件不存在，或者你想创建一个新的，可以使用 Workbook()
# wb = openpyxl.Workbook()
try:
    wb = openpyxl.load_workbook('file.xlsx')
except FileNotFoundError:
    print("文件 'file.xlsx' 不存在，将创建一个新的工作簿。")
    wb = openpyxl.Workbook()
    # 创建一些示例工作表以便后续操作
    wb.create_sheet("sheet1")
    wb.create_sheet("sheet2")
    wb.create_sheet("sheet3")
    wb.remove(wb['Sheet']) # 移除默认创建的'Sheet'

# 选择要操作的工作表
# 可以通过名称访问，例如：ws = wb['sheet1']
# 也可以遍历所有工作表

3. 设置单元格样式：填充与字体

openpyxl通过PatternFill对象设置单元格背景填充，通过Font对象设置字体样式。

3.1 设置单元格背景填充

PatternFill用于定义单元格的背景颜色和填充模式。最常用的是solid填充类型，配合start_color和end_color（对于solid类型，两者通常相同）来设置纯色背景。颜色值通常使用RGB或ARGB十六进制字符串表示。

# 定义一个蓝色背景填充
blue_fill = PatternFill(start_color='4F81BD', end_color='4F81BD', fill_type='solid')

# 示例：将'sheet1'的A1单元格设置为蓝色背景
# ws = wb['sheet1']
# cell_a1 = ws['A1']
# cell_a1.fill = blue_fill

3.2 设置单元格字体颜色

这是本教程的重点。Font对象用于设置字体名称、大小、加粗、斜体以及颜色。color参数是设置字体颜色的关键。

常见错误与原因：

在使用Font(color=...)时，一个常见的错误是ValueError: Colors must be aRGB hex values。这通常发生在color参数接收到一个不符合openpyxl期望的颜色格式时。openpyxl要求颜色值是8位的ARGB（Alpha, Red, Green, Blue）十六进制字符串（例如，'FFFFFFFF'代表不透明的白色）或一个openpyxl.styles.Color对象。

解决方案：

使用预定义的颜色常量并转换为Color对象： openpyxl.styles.colors模块提供了一些预定义的颜色常量，如colors.WHITE。虽然这些常量本身是ARGB十六进制字符串（例如colors.WHITE是'FFFFFFFF'），但为了确保兼容性和鲁棒性，特别是在遇到ValueError时，建议将其显式转换为openpyxl.styles.Color对象。

from openpyxl.styles import Font, Color
from openpyxl.styles import colors # 导入colors模块

# 正确设置白色字体颜色
# 方案一：显式创建Color对象
white_font_color_obj = Color(colors.WHITE.get_hex_color()) # 获取hex值并创建Color对象
# 或者直接使用hex字符串创建Color对象
# white_font_color_obj = Color('FFFFFFFF')

# 创建字体对象
white_bold_font = Font(color=white_font_color_obj, bold=True)

直接使用ARGB十六进制字符串： 如果你确定颜色值的格式是正确的ARGB十六进制字符串（例如'FFFFFFFF'代表不透明的白色，'00000000'代表透明的黑色，'FF0000FF'代表不透明的蓝色），也可以直接将其作为字符串传递给Font的color参数。
```
# 方案二：直接使用ARGB十六进制字符串
white_bold_font_str = Font(color='FFFFFFFF', bold=True)
```
尽管colors.WHITE本身就是'FFFFFFFF'字符串，但在某些特定版本或环境中，直接使用colors.WHITE可能会触发上述ValueError。因此，通过colors.Color(colors.WHITE.get_hex_color())显式创建Color对象是最稳妥的做法。

4. 完整示例代码

以下是一个完整的示例，演示如何加载一个Excel文件（或创建新文件），遍历指定的工作表，为第一行单元格设置蓝色背景和白色加粗字体，最后保存修改。

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

# 1. 加载或创建工作簿
file_name = 'updated_file.xlsx' # 输出文件名
original_file = 'file.xlsx' # 尝试加载的原始文件

try:
    wb = openpyxl.load_workbook(original_file)
    print(f"成功加载文件: {original_file}")
except FileNotFoundError:
    print(f"文件 '{original_file}' 不存在，将创建一个新的工作簿。")
    wb = openpyxl.Workbook()
    # 确保有示例工作表
    if 'Sheet' in wb.sheetnames:
        wb.remove(wb['Sheet']) # 移除默认创建的'Sheet'
    wb.create_sheet("sheet1")
    wb.create_sheet("sheet2")
    wb.create_sheet("sheet3")
    print("已创建 'sheet1', 'sheet2', 'sheet3' 作为示例工作表。")

# 2. 定义要操作的工作表列表
keep_sheets = ['sheet3', 'sheet2', 'sheet1']

# 3. 定义样式
# 蓝色背景填充
blue_fill = PatternFill(start_color='4F81BD', end_color='4F81BD', fill_type='solid')

# 白色加粗字体 (解决ValueError的关键)
# 推荐使用 Color 对象来确保兼容性
white_bold_font = Font(color=Color(colors.WHITE.get_hex_color()), bold=True)
# 也可以直接使用 ARGB hex 字符串，但如果遇到问题，请切换到上面 Color 对象的方式
# white_bold_font = Font(color='FFFFFFFF', bold=True)


# 4. 遍历工作表并应用样式
for sheet_name in wb.sheetnames:
    if sheet_name in keep_sheets:
        ws = wb[sheet_name]
        print(f"正在处理工作表: {ws.title}")

        # 假设我们只对前10列 (A到J) 的第一行进行操作
        for col_idx in range(1, 11): # 1 to 10 corresponds to A to J
            cell = ws.cell(row=1, column=col_idx)
            # 设置单元格值 (可选，为了演示效果)
            cell.value = f"{ws.title} Col {chr(64 + col_idx)}"
            # 应用背景填充
            cell.fill = blue_fill
            # 应用字体样式
            cell.font = white_bold_font

# 5. 保存修改
try:
    wb.save(file_name)
    print(f"文件 '{file_name}' 已成功保存。")
except Exception as e:
    print(f"保存文件时发生错误: {e}")

5. 注意事项与总结

颜色格式： openpyxl的颜色值通常期望为8位ARGB（Alpha, Red, Green, Blue）十六进制字符串。例如，'FFFFFFFF'代表不透明的白色，'FF000000'代表不透明的黑色。前两位FF表示完全不透明。
openpyxl.styles.colors.Color对象： 尽管可以直接使用十六进制字符串，但为了避免潜在的兼容性问题或明确指定颜色类型，推荐使用Color对象来封装颜色值，如Color('FFFFFFFF')或Color(colors.WHITE.get_hex_color())。
保存操作： 所有的修改都只存在于内存中，必须调用wb.save('your_file.xlsx')才能将更改写入到实际的Excel文件中。
其他字体属性： Font对象还支持设置其他属性，如name（字体名称）、size（字号）、italic（斜体）、strike（删除线）、underline（下划线）等。例如：Font(name='Arial', size=12, italic=True)。
错误排查： 当遇到ValueError: Colors must be aRGB hex values时，请首先检查传递给Font或PatternFill的颜色值是否为正确的ARGB十六进制字符串，或是否正确地创建了openpyxl.styles.Color对象。

通过掌握openpyxl库中样式设置的正确方法，特别是对颜色格式的理解和应用，你可以灵活高效地定制Excel文件的外观，满足各种数据展示需求。

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