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文件的外观，满足各种数据展示需求。
