openpyxl 常见操作
目录
1. 基础工作簿操作
1.1 打开与创建
from openpyxl import Workbook, load_workbook
# 创建新文件(默认自带一个名为 Sheet 的工作表)
wb = Workbook()
# 打开现有文件
wb = load_workbook("demo.xlsx")
# 只读模式打开(处理大文件时推荐,不支持修改,但速度快)
wb = load_workbook("demo.xlsx", read_only=True)
1.2 保存与关闭
# 保存文件(数据必须 save 后才会真正写入硬盘)
wb.save("demo.xlsx")
# --- 关闭 ---
# 法 1:使用 with 语句(最稳妥)
with Workbook() as wb:
ws = wb.active
ws['A1'] = "Hello"
wb.save("test.xlsx")
# 法2:使用 del 对象回收内存
del wb
#法3
wb.close()
2. Sheet 表操作
# 获取当前激活的 Sheet
ws = wb.active
# 通过名字获取
ws = wb["Sheet1"]
# 新建 Sheet 并激活
ws_new = wb.create_sheet(title="新数据表")
wb.active = ws_new
# 获取所有 Sheet 名称列表
names = wb.sheetnames
3. 数据读取
# 按行循环读取(values_only=True 直接返回值,不返回 Cell 对象)
for row in ws.iter_rows(values_only=True):
print(row)
# 读取指定区域(例如读取 B2 到 C4)
for row in ws.iter_rows(min_row=2, max_row=4, min_col=2, max_col=3, values_only=True):
print(row)
4. 数据写入(含按列/按列名高级用法)
4.1 按行写入
# 1. 按坐标写入
ws['B2'] = "坐标写入"
# 2. 按行列号写入
ws.cell(row=2, column=3, value="行列号写入")
# 3. 按行追加(批量数据首选,效率最高)
data_rows = [["张三", 90], ["李四", 85]]
for row in data_rows:
ws.append(row)
4.2 按列写入(无现成方法,需精确定位)
核心:
openpyxl没有按列追加的方法,必须通过循环结合ws.cell(row=, column=)实现。
方式 A:一维列表按列循环
col_data = ["苹果", "香蕉", "橘子"]
target_col = 2 # B 列
start_row = 2
for index, value in enumerate(col_data):
ws.cell(row=start_row + index, column=target_col, value=value)
方式 B:二维数据按列写入(借助 zip(*data) 转置)
data_rows = [[1, "张三", 90], [2, "李四", 85]] # 原本按行的数据
start_col = 2
for col_index, col_data in enumerate(zip(*data_rows)):
for row_index, value in enumerate(col_data, start=1):
ws.cell(row=row_index, column=start_col + col_index, value=value)
4.3 按列名(表头)动态写入数据
核心:先定位表头在哪一列,再用
ws.cell()精准写入。
方案 A:单列名匹配写入
target_header = "年龄"
col_index = None
# 1. 遍历第一行,找到目标列名对应的列号
for cell in ws[1]:
if cell.value == target_header:
col_index = cell.column
break
# 2. 写入数据
if col_index:
age_data = [25, 30, 28]
start_row = 2
for index, value in enumerate(age_data):
ws.cell(row=start_row + index, column=col_index, value=value)
方案 B:字典批量映射写入(最优雅)
data_to_write = [
{"姓名": "张三", "年龄": 25, "城市": "北京"},
{"姓名": "李四", "年龄": 30, "城市": "上海"}
]
# 1. 构建表头与列号的映射字典 {'姓名': 1, '年龄': 2, ...}
header_map = {}
for cell in ws[1]:
if cell.value:
header_map[str(cell.value).strip()] = cell.column
# 2. 循环写入数据
start_row = ws.max_row + 1
for row_idx, row_dict in enumerate(data_to_write):
current_row = start_row + row_idx
for header_name, cell_value in row_dict.items():
if header_name in header_map:
ws.cell(row=current_row, column=header_map[header_name], value=cell_value)
合并单元格避坑:如果表头是合并单元格,
openpyxl只会保留左上角的值,其余为None。需先用ws.merged_cells.ranges解析合并区域,才能正确获取列名。
5. 颜色读取与设置
openpyxl 本身不支持截图,因为它没有渲染引擎。以下是常用替代方案:
import xlwings as xw
app = xw.App(visible=False, add_book=False)
wb = app.books.open("demo.xlsx")
ws = wb.sheets[0]
rng = ws.range("A1:D10")
rng.api.CopyPicture(Format=2)
chart = ws.charts.add()
chart.api[1].ChartArea.Select()
ws.api.Paste()
chart.api[1].Export("screenshot.png")
chart.delete()
wb.close()
app.quit()