Python使用openpyxl生成、读取、修改Excel

日常办公中，Excel的身影无处不在：整理销售数据、统计考勤、合并表格、批量调整格式、为领导生成周报……如果每次都依赖手动复制、筛选、修改颜色，不仅效率低下，还容易出错。

想要摆脱这种重复劳动？openpyxl这个Python库是个绝佳选择。它专门用于处理.xlsx格式的Excel文件，功能强大且易于上手。下面，我们就通过一份完整的演示代码，手把手带你掌握三个最核心的高频操作：生成新文件、读取已有内容以及修改现有表格。无论你是Python新手，还是希望提升办公效率的职场人，这套流程都值得一试。

一、安装 openpyxl

万事开头先安装。打开你的命令行工具，输入以下命令：

pip install openpyxl

如果你的系统里有多个Python版本，为了确保安装到正确的位置，可以使用：

python -m pip install openpyxl

二、完整演示代码

纸上得来终觉浅，我们直接看代码。下面这段脚本完成了一个从创建到读取再到修改的完整闭环：

1. 生成一份名为student_score.xlsx的学生成绩表。
2. 写入数据，并设置标题、表头、列宽、颜色，甚至冻结窗格。
3. 读取这个Excel文件，并将内容打印到控制台。
4. 修改文件：为每位学生计算平均分、评定等级、添加备注，最后另存为新文件。

建议你新建一个openpyxl_excel_demo.py文件，将以下代码复制进去，直接运行就能看到效果。

from pathlib import Path

from openpyxl import Workbook, load_workbook
from openpyxl.styles import Font, PatternFill, Alignment, Border, Side
from openpyxl.utils import get_column_letter


BASE_DIR = Path(__file__).resolve().parent
SOURCE_FILE = BASE_DIR / "student_score.xlsx"
UPDATED_FILE = BASE_DIR / "student_score_updated.xlsx"


def create_excel(file_path: Path) -> None:
    """生成一份学生成绩 Excel。"""
    wb = Workbook()
    ws = wb.active
    ws.title = "成绩表"

    # 标题
    ws.merge_cells("A1:F1")
    ws["A1"] = "学生成绩统计表"
    ws["A1"].font = Font(name="微软雅黑", size=16, bold=True, color="FFFFFF")
    ws["A1"].fill = PatternFill("solid", fgColor="4472C4")
    ws["A1"].alignment = Alignment(horizontal="center", vertical="center")
    ws.row_dimensions[1].height = 28

    # 表头和数据
    headers = ["学号", "姓名", "语文", "数学", "英语", "班级"]
    rows = [
        [1001, "张三", 88, 92, 85, "一班"],
        [1002, "李四", 76, 81, 79, "一班"],
        [1003, "王五", 95, 89, 93, "二班"],
        [1004, "赵六", 68, 72, 70, "二班"],
        [1005, "孙七", 84, 86, 91, "三班"],
    ]

    ws.append([])
    ws.append(headers)
    for row in rows:
        ws.append(row)

    # 样式
    header_fill = PatternFill("solid", fgColor="D9EAF7")
    thin = Side(style="thin", color="D9D9D9")
    border = Border(left=thin, right=thin, top=thin, bottom=thin)

    for row in ws.iter_rows(min_row=3, max_row=ws.max_row, min_col=1, max_col=6):
        for cell in row:
            cell.border = border
            cell.alignment = Alignment(horizontal="center", vertical="center")

    for cell in ws[3]:
        cell.font = Font(bold=True)
        cell.fill = header_fill

    # 设置列宽
    column_widths = [12, 12, 10, 10, 10, 12]
    for index, width in enumerate(column_widths, start=1):
        ws.column_dimensions[get_column_letter(index)].width = width

    # 冻结表头，开启筛选
    ws.freeze_panes = "A4"
    ws.auto_filter.ref = f"A3:F{ws.max_row}"

    wb.sa ve(file_path)
    print(f"已生成 Excel：{file_path}")


def read_excel(file_path: Path) -> None:
    """读取 Excel 内容并打印。"""
    wb = load_workbook(file_path)
    ws = wb["成绩表"]

    print("\n读取 Excel 内容：")
    for row in ws.iter_rows(min_row=4, values_only=True):
        student_id, name, chinese, math, english, class_name = row
        print(
            f"学号：{student_id}，姓名：{name}，"
            f"语文：{chinese}，数学：{math}，英语：{english}，班级：{class_name}"
        )


def update_excel(source_path: Path, target_path: Path) -> None:
    """修改 Excel，增加平均分、等级、备注。"""
    wb = load_workbook(source_path)
    ws = wb["成绩表"]

    # 新增表头
    ws["G3"] = "平均分"
    ws["H3"] = "等级"
    ws["I3"] = "备注"

    for cell in ws[3]:
        cell.font = Font(bold=True)
        cell.fill = PatternFill("solid", fgColor="D9EAF7")
        cell.alignment = Alignment(horizontal="center", vertical="center")

    for row_index in range(4, ws.max_row + 1):
        chinese = ws.cell(row=row_index, column=3).value
        math = ws.cell(row=row_index, column=4).value
        english = ws.cell(row=row_index, column=5).value

        a verage = round((chinese + math + english) / 3, 2)
        ws.cell(row=row_index, column=7).value = a verage

        if a verage >= 90:
            level = "优秀"
            remark = "继续保持"
        elif a verage >= 80:
            level = "良好"
            remark = "表现稳定"
        elif a verage >= 70:
            level = "合格"
            remark = "仍有提升空间"
        else:
            level = "待提升"
            remark = "建议重点辅导"

        ws.cell(row=row_index, column=8).value = level
        ws.cell(row=row_index, column=9).value = remark

    # 给新增区域补样式
    thin = Side(style="thin", color="D9D9D9")
    border = Border(left=thin, right=thin, top=thin, bottom=thin)
    for row in ws.iter_rows(min_row=3, max_row=ws.max_row, min_col=1, max_col=9):
        for cell in row:
            cell.border = border
            cell.alignment = Alignment(horizontal="center", vertical="center")

    for column in range(7, 10):
        ws.column_dimensions[get_column_letter(column)].width = 14

    ws.auto_filter.ref = f"A3:I{ws.max_row}"
    wb.sa ve(target_path)
    print(f"\n已修改并另存为：{target_path}")


def main() -> None:
    create_excel(SOURCE_FILE)
    read_excel(SOURCE_FILE)
    update_excel(SOURCE_FILE, UPDATED_FILE)


if __name__ == "__main__":
    main()

三、代码运行后会得到什么

在终端运行这个脚本：

python openpyxl_excel_demo.py

执行完毕后，你会在当前目录下看到两个新生成的Excel文件：

• student_score.xlsx：原始的学生成绩表。
• student_score_updated.xlsx：增加了“平均分”、“等级”、“备注”三列的新表格。

同时，控制台会输出读取到的数据，类似下面这样：

已生成 Excel：student_score.xlsx

读取 Excel 内容：
学号：1001，姓名：张三，语文：88，数学：92，英语：85，班级：一班
学号：1002，姓名：李四，语文：76，数学：81，英语：79，班级：一班
...

已修改并另存为：student_score_updated.xlsx

四、核心知识点拆解

光看整体流程可能有点眼花，我们来把关键步骤拆开揉碎了讲。

1. 创建工作簿

wb = Workbook()
ws = wb.active
ws.title = "成绩表"

这三行是起点。Workbook()创建了一个全新的Excel工作簿。wb.active获取当前活动的工作表（默认是第一个）。ws.title则是给这个工作表起个名字。

2. 写入单元格

ws["A1"] = "学生成绩统计表"
ws.append(["学号", "姓名", "语文", "数学", "英语", "班级"])

写入数据有两种主流方式：一种是像ws[“A1”]这样精准定位到某个单元格；另一种是ws.append([...])，它会在表格末尾自动新增一行，非常适合批量写入结构化的行数据。

3. 读取工作簿

wb = load_workbook("student_score.xlsx")
ws = wb["成绩表"]

读取已有文件，要用load_workbook()函数。如果文件里有多个工作表，可以通过名称（如“成绩表”）来指定要操作哪一个。

4. 遍历行数据

for row in ws.iter_rows(min_row=4, values_only=True):
    print(row)

iter_rows()是批量处理数据的利器。min_row=4参数告诉它从第4行开始读取，跳过了标题和表头。values_only=True则意味着直接返回单元格的值，而不是整个单元格对象，这让后续的数据处理更简洁。

5. 修改并保存为新文件

wb = load_workbook("student_score.xlsx")
ws = wb["成绩表"]
ws["G3"] = "平均分"
wb.sa ve("student_score_updated.xlsx")

这里有个重要的实践建议：修改文件时，最好另存为新文件，而不是直接覆盖原文件。这样做的好处是，万一脚本运行出错，原始数据依然完好无损，给了你回滚和调试的机会。

五、openpyxl 适合哪些办公自动化场景

掌握了基础操作，openpyxl能帮你解决哪些实际痛点呢？它的用武之地非常广泛：

• 报表自动化：批量生成格式统一的日报、周报、月报。
• 数据汇总：自动读取多个分散的Excel文件，合并关键数据。
• 格式美化：一键为表格添加标准表头、设置颜色边框、调整列宽。
• 智能判断：根据分数自动划分等级，根据金额区间添加标记，根据状态填充不同颜色。
• 数据清洗：自动筛选出异常值或符合特定条件的数据行。
• 模板填充：将数据自动填入预设好公式和格式的统计模板中。

简而言之，凡是让你感到重复、繁琐、耗时的Excel手工操作，都值得考虑用openpyxl写个脚本来自动化。

六、学习建议

对于初学者，不必一开始就追求复杂功能。可以遵循一个循序渐进的路径：

1. 第一步，先学会创建新Excel并写入几行数据。
2. 第二步，练习读取已有Excel文件的内容。
3. 第三步，尝试修改单元格里的值或格式。
4. 第四步，深入学习样式设置、列宽调整、冻结窗格、自动筛选等进阶功能。
5. 最后，将以上技能组合起来，针对你手头真实、重复的工作任务，编写一个完整的自动化脚本。

Python办公自动化的精髓，不在于代码有多高深，而在于能否将那些每天占用你30分钟、甚至更久的重复劳动，转化为一个3秒就能执行完毕的脚本。这才是效率提升的关键所在。

七、总结

通过上面这份完整的代码演示，我们走通了使用openpyxl进行Excel生成、读取和修改的核心流程。你可以把这份脚本当作一个“模板”，将其中的学生成绩字段，替换成你自己的业务数据，比如员工信息、销售订单、项目进度或者库存记录。

打好这些基础之后，再进一步探索公式计算、图表生成、多文件合并以及批量报表生成等高级功能，Python处理Excel的效率优势将会体现得更加淋漓尽致。从重复操作中解放出来，将精力投入到更有价值的分析思考和决策中去，这才是学习自动化的最终目的。