Python办公自动化-第04讲-批量新建Excel

第 4 讲 | 批量新建 Excel:按模板一键生成 N 个文件

本文是《Python 办公自动化实战》第 4 讲。

从这一讲开始,正式进入"省时间"环节。

配套代码:lessons/L04_batch_create.py

---git clone https://gitee.com/wuyikui555/python-office-auto.git

一、场景:为什么需要"批量新建"

场景:公司有 5 个大区,财务需要每个大区一份"2026 年度预算表",格式完全一样,只是表头和文件名不同。

手动做:新建文件 → 写标题 → 写表头 → 设颜色 → 设列宽 → 写数据 → 另存为"华东大区_2026预算表.xlsx" → 再重复 4 次。每个文件 3 分钟,5 个就是 15 分钟。

每个月都要做一次?那一年就是 3 小时。

关键洞察 :"格式完全一样,只是内容/文件名不同"------这就是自动化的最佳场景。


二、核心思路:样式封装成函数

批量生成最容易犯的错是把样式代码写进循环:

python 复制代码
# ❌ 不推荐:样式代码在循环里,又长又难维护
for dep in DEPARTMENTS:
    wb = Workbook()
    ws = wb.active
    for col, text in enumerate(HEADER, start=1):
        cell = ws.cell(row=1, column=col, value=text)
        cell.fill = PatternFill("solid", fgColor="4472C4")
        cell.font = Font(bold=True, color="FFFFFF")
        cell.alignment = Alignment(horizontal="center")
    # ... 20 行样式代码

正确做法:把"美化表头"抽成一个函数。

python 复制代码
# ✅ 推荐:样式只在函数里写一遍
def style_header(ws, header: list[str], row: int = 1) -> None:
    """把某一行的表头统一样式:蓝底白字加粗居中 + 细边框。"""
    fill = PatternFill("solid", fgColor="4472C4")
    font = Font(bold=True, color="FFFFFF")
    thin = Side(style="thin", color="BFBFBF")
    border = Border(left=thin, right=thin, top=thin, bottom=thin)
    for col, text in enumerate(header, start=1):
        cell = ws.cell(row=row, column=col, value=text)
        cell.fill = fill
        cell.font = font
        cell.alignment = Alignment(horizontal="center", vertical="center")
        cell.border = border

循环里就只剩三行:

python 复制代码
for dep in DEPARTMENTS:
    wb = Workbook()
    ws = wb.active
    ws.title = f"{dep}预算"
    style_header(ws, BUDGET_HEADER, row=2)      # ← 一行搞定表头
    ...
    wb.save(out_dir / f"{dep}大区_2026预算表.xlsx")

这个"封装样式函数"的思路,会贯穿整个课程。 后面第 9 讲还会把它升级成一个更通用的美化工具。


三、完整代码拆解

看 lessons/L04_batch_create.py 的第一个函数:

python 复制代码
def make_department_budgets() -> None:
    """按部门批量生成预算表(核心示例)。"""
    out_dir = ensure_dir(OUTPUT_DIR / "第04讲" / "部门预算")

    for dep in DEPARTMENTS:
        wb = Workbook()
        ws = wb.active
        ws.title = f"{dep}预算"

        # ① 标题行(合并单元格)
        ws.merge_cells("A1:E1")
        ws["A1"] = f"{dep}大区 · 2026 年度预算表"
        ws["A1"].font = Font(bold=True, size=14)
        ws["A1"].alignment = Alignment(horizontal="center", vertical="center")

        # ② 表头(复用样式函数)
        style_header(ws, BUDGET_HEADER, row=2)

        # ③ 数据行(含公式和数字格式)
        for i, subject in enumerate(BUDGET_ROWS, start=3):
            budget = (i - 1) * 50000
            actual = int(budget * 0.85)
            ws.cell(row=i, column=1, value=subject)
            ws.cell(row=i, column=2, value=budget)
            ws.cell(row=i, column=3, value=actual)
            ws.cell(row=i, column=4, value=f"=B{i}-C{i}")     # 差额(公式)
            rate = ws.cell(row=i, column=5, value=f"=C{i}/B{i}")
            rate.number_format = "0.0%"                        # 百分比格式

        # ④ 列宽
        for col, width in zip("ABCDE", (14, 14, 14, 12, 10)):
            ws.column_dimensions[col].width = width

        path = out_dir / f"{dep}大区_2026预算表.xlsx"
        wb.save(path)
        log.info("  生成 %s", path.name)

四个要点:

  1. ensure_dir() 先建目录 ------wb.save() 不会自动创建父目录,目录不存在直接报错。
  2. ws.title = f"{dep}预算"------让每个文件的 Sheet 名也带上部门,打开就知道是谁的。
  3. 公式用 f-string 拼 ------f"=B{i}-C{i}",i 是当前行号。注意公式里不要写绝对引用 $(除非你真需要)。
  4. 数字格式用 number_format ------"0.0%" 会自动把 0.85 显示成 85.0%。

运行结果:

复制代码
[INFO] --- 1. 按部门批量生成预算表 ---
[INFO]   生成 华东大区_2026预算表.xlsx
[INFO]   生成 华北大区_2026预算表.xlsx
[INFO]   生成 华南大区_2026预算表.xlsx
[INFO]   生成 西南大区_2026预算表.xlsx
[INFO]   生成 华中大区_2026预算表.xlsx

5 个文件,1 秒内全部生成。


四、进阶:目录和文件一起批量建

第二个函数演示"按月份批量创建目录 + 台账文件":

python 复制代码
def make_monthly_folders() -> None:
    base = ensure_dir(OUTPUT_DIR / "第04讲" / "月度台账")

    for month in range(1, 13):
        month_dir = ensure_dir(base / f"2026-{month:02d}")     # 建目录
        wb = Workbook()
        ws = wb.active
        ws.title = f"{month}月"
        ws.append(["日期", "部门", "摘要", "收入", "支出", "备注"])
        wb.save(month_dir / f"2026年{month:02d}月台账.xlsx")     # 建文件

注意 {month:02d} ------这是格式化补零,1 会变成 01。批量生成文件时,序号一定要补零 ,否则排序会变成 1, 10, 11, 2 这种。

运行后:

复制代码
data/output/第04讲/月度台账/
├── 2026-01/2026年01月台账.xlsx
├── 2026-02/2026年02月台账.xlsx
├── ...
└── 2026-12/2026年12月台账.xlsx

12 个目录 + 12 个文件,一行循环搞定。


五、可复用的"批量生成"模板

把这套思路抽象出来,以后遇到"批量生成 N 个文件"直接套:

python 复制代码
def batch_generate(items: list, template_func, out_dir, name_func):
    """
    items        : 要生成的对象列表(部门名、月份、员工名单......)
    template_func: 一个函数,接收 item 和 ws,负责写内容
    name_func    : 一个函数,接收 item,返回文件名
    """
    ensure_dir(out_dir)
    for item in items:
        wb = Workbook()
        ws = wb.active
        template_func(item, ws)                    # 写内容
        wb.save(out_dir / name_func(item))         # 存文件


# 使用
batch_generate(
    DEPARTMENTS,
    template_func=lambda dep, ws: fill_budget(ws, dep),
    out_dir=OUTPUT_DIR / "预算表",
    name_func=lambda dep: f"{dep}大区_2026预算表.xlsx",
)

这就是"把重复劳动抽象成函数"的思维------也是写自动化脚本的核心能力。


六、三个实用细节

1. 文件名不能含非法字符

Windows 文件名不能包含 \ / : * ? " < > |。如果部门名来自用户输入,先清洗:

python 复制代码
import re

def safe_filename(name: str) -> str:
    """把文件名里的非法字符替换成下划线。"""
    return re.sub(r'[\\/:*?"<>|]', "_", name).strip()

2. 覆盖还是跳过?

批量生成时,如果文件已存在,wb.save() 会静默覆盖。如果你不想覆盖:

python 复制代码
path = out_dir / f"{dep}_预算表.xlsx"
if path.exists():
    log.info("  跳过已存在:%s", path.name)
    continue
wb.save(path)

3. 加一个"生成报告"

批量生成几百个文件时,最好输出一份清单:

python 复制代码
created = []
for dep in DEPARTMENTS:
    ...
    wb.save(path)
    created.append(path.name)

log.info("共生成 %d 个文件:%s", len(created), "、".join(created))

七、本讲小结

  1. 批量新建的适用场景:格式一样、内容或文件名不同。
  2. 核心技巧 :把样式封装成函数,循环里只留数据逻辑。
  3. 必做两步 :ensure_dir() 建目录、序号用 {n:02d} 补零。
  4. 抽象模板 :batch_generate(items, template_func, out_dir, name_func)。
  5. 细节:文件名非法字符清洗、是否覆盖、生成清单。

八、代码

python 复制代码
# -*- coding: utf-8 -*-
"""
第 4 讲配套脚本:批量新建 Excel ------ 按模板一键生成 N 个文件

覆盖知识点:
    1. 用循环 + openpyxl 批量生成结构相同的文件
    2. 表头样式复用(避免每个文件重新写一遍)
    3. 按"部门""月份"等维度批量命名
    4. 批量创建配套目录结构
运行:python lessons/L04_batch_create.py
"""

from __future__ import annotations

import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent.parent))

from openpyxl import Workbook                                    # noqa: E402
from openpyxl.styles import Alignment, Border, Font, PatternFill, Side  # noqa: E402

from utils.helpers import OUTPUT_DIR, ensure_dir, get_logger     # noqa: E402

log = get_logger("L04")

DEPARTMENTS = ["华东", "华北", "华南", "西南", "华中"]

# 预算表表头
BUDGET_HEADER = ["科目", "季度预算(元)", "实际支出(元)", "差额(元)", "执行率"]
BUDGET_ROWS = ["市场推广费", "差旅费", "办公费", "人员成本", "其他"]


def style_header(ws, header: list[str], row: int = 1) -> None:
    """把某一行的表头统一样式:蓝底白字加粗居中 + 细边框。"""
    fill = PatternFill("solid", fgColor="4472C4")
    font = Font(bold=True, color="FFFFFF")
    thin = Side(style="thin", color="BFBFBF")
    border = Border(left=thin, right=thin, top=thin, bottom=thin)
    for col, text in enumerate(header, start=1):
        cell = ws.cell(row=row, column=col, value=text)
        cell.fill = fill
        cell.font = font
        cell.alignment = Alignment(horizontal="center", vertical="center")
        cell.border = border


def make_department_budgets() -> None:
    """按部门批量生成预算表(核心示例)。"""
    log.info("--- 1. 按部门批量生成预算表 ---")
    out_dir = ensure_dir(OUTPUT_DIR / "第04讲" / "部门预算")

    for dep in DEPARTMENTS:
        wb = Workbook()
        ws = wb.active
        ws.title = f"{dep}预算"

        # 标题行
        ws.merge_cells("A1:E1")
        ws["A1"] = f"{dep}大区 · 2026 年度预算表"
        ws["A1"].font = Font(bold=True, size=14)
        ws["A1"].alignment = Alignment(horizontal="center", vertical="center")

        # 表头(第 2 行)
        style_header(ws, BUDGET_HEADER, row=2)

        # 数据行
        for i, subject in enumerate(BUDGET_ROWS, start=3):
            budget = (i - 1) * 50000
            actual = int(budget * 0.85)
            ws.cell(row=i, column=1, value=subject)
            ws.cell(row=i, column=2, value=budget)
            ws.cell(row=i, column=3, value=actual)
            ws.cell(row=i, column=4, value=f"=B{i}-C{i}")          # 写公式
            rate = ws.cell(row=i, column=5, value=f"=C{i}/B{i}")
            rate.number_format = "0.0%"                            # 百分比格式

        for col, width in zip("ABCDE", (14, 14, 14, 12, 10)):
            ws.column_dimensions[col].width = width

        path = out_dir / f"{dep}大区_2026预算表.xlsx"
        wb.save(path)
        log.info("  生成 %s", path.name)


def make_monthly_folders() -> None:
    """按月份批量创建目录 + 空白台账文件(演示目录与文件一起批量建)。"""
    log.info("--- 2. 按月份批量创建目录与台账 ---")
    base = ensure_dir(OUTPUT_DIR / "第04讲" / "月度台账")

    for month in range(1, 13):
        month_dir = ensure_dir(base / f"2026-{month:02d}")
        wb = Workbook()
        ws = wb.active
        ws.title = f"{month}月"
        ws.append(["日期", "部门", "摘要", "收入", "支出", "备注"])
        wb.save(month_dir / f"2026年{month:02d}月台账.xlsx")
    log.info("  已生成 12 个月份目录及台账文件")


def main() -> None:
    make_department_budgets()
    make_monthly_folders()
    log.info("第 4 讲演示结束,输出目录:data/output/第04讲/")


if __name__ == "__main__":
    main()

下一讲预告

文件批量创建出来了,但原文件名往往一团糟------带网址前缀、带空格、编号混乱。

第 5 讲讲批量重命名与文件整理 :os、shutil、pathlib 三个模块的实战用法,包括加前缀、批量替换、按序号重排、按关键词归类,还有**"安全删除"的正确姿势**(先移进回收目录,而不是直接 os.remove)。


本专栏是《Python 办公自动化实战》第 4 讲,共 20 讲。配套代码:lessons/L04_batch_create.py

相关推荐
wuyk55512 分钟前
Spider-第20讲-综合实战可上线爬虫
大数据·爬虫·python·elasticsearch
code2cat1 小时前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http
JonaHu1 小时前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
prince_zxill2 小时前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
少司府2 小时前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
伞伞悦读3 小时前
【第90期】KNN分类回归流水线与K值对照的实验与排查
大数据·人工智能·python·深度学习·机器学习
ScilogyHunter4 小时前
[14] TMS570LC4357_VIM向量中断:128 通道、双 VIM 与硬件向量分发
单片机·编辑器·vim·excel·hercules·tms570
console.log('npc')4 小时前
Python 学习教程 · 第4课:数据结构
数据结构·python·学习
honker_X4 小时前
Python字符串全攻略:从入门到精通
开发语言·python