每月 1 号自动生成月报：定时任务加模板

每月 1 号做月报，2 个半小时里有 1 个半小时在搬数据。用「固定导出表头 + 模板占位 + 脚本填数 + 定时器」四步，能把这件事压到 3 分钟生成、12 分钟复核。本文给这套流程，以及三个会让你发出错数字的坑——最狠的一个是 1 月跑出来取的是 11 月的数据。

一句话结论

月报能不能自动化，关键不在脚本写得多好，而在数据源的列名能不能固定下来。顺序是：先把 8 个指标的口径和公式写死、把导出表头钉住，再套模板、最后才写脚本。实测手工 2.5 小时（其中 1.5 小时在整理数据），自动化后每月 3 分钟生成加 12 分钟复核，搭建用了 3 小时。踩得最狠的坑不是代码，是日期口径：用「当前月减 1」取上月，1 月会算成 0 月，某些写法直接掉到 11 月。

这篇解决什么问题

三种情况最常见。一是每个月都在改脚本：导出多一列、列名从「订单数」变成「订单量」，脚本就报错，改完下个月又变。二是口径不一致，你按自然月、财务按结算月，会上对不上。三是发出去才发现某行是空的、被填成了 0，一个门店的客单价把整体拉下一半。

根子是把这件事当成「写个脚本」，而它其实是「把一份固定格式的报表变成一个可重复的产出」：口径要写死、表头要约定、异常要显式暴露而不是悄悄变 0。五步做完，得到一个固定表头的导出模板、一份带占位符的月报模板、一个能重跑的脚本，以及一条每月自动触发的定时任务。

开始前要准备什么

• 一份上个月的月报，作为目标格式：不用重新设计。要自动化的前提是「长得跟以前一样」，变了格式，读的人反而先不认。
• 8 个指标的公式，写到能让人照着算一遍：每个指标写清分子分母、时间范围、排除项（退货算不算、内部单算不算）。口径不写死，脚本算得再准也会被推翻。
• 一个能稳定导出的数据源：优先选能从后台导出 CSV 的地方，别直接连生产库读表——读表看起来省一步，但表结构一改你就得连夜修脚本。
• 一台常开的机器：公司电脑、服务器、或者一台一直开着的旧笔记本都行。定时任务要挂在不会关机的地方，否则 1 号恰好没开机，这个月就断了。

具体怎么做

第一步：把 8 个指标的公式写死，先对齐再动手

这一步花 40 分钟，能省掉后面所有的返工。每个指标写四行：定义、公式、时间范围、缺值怎么处理。实测最容易出分歧的是「客单价」——是按订单金额除以订单数，还是除以成交人数；以及「新客」——是首次下单，还是首次注册。这两条不定，后面每个月的数字都会被人质疑一次。

这是我们月报里的 8 个指标名称：（列出）
这是上个月的月报数字（截图或表格）：（粘贴）

请帮我把每个指标的口径补成四行：定义 / 公式（分子分母写清）/ 时间范围（自然月还是结算月）/ 缺值怎么处理（记 0、显示「—」、还是跳过）。

要求：
1. 公式里出现的字段名，必须是我导出表里真实存在的列，不许自己造；
2. 对每个指标标一句「最容易和谁的口径打架」，例如财务、门店、运营；
3. 明确指出哪几个指标在没有明细数据时算不出来 —— 我要提前知道哪些只能手工填。

第二步：把导出的表头钉住，加一层「列名映射」

不要让脚本直接依赖数据源的列名。加一层映射表：左边是脚本里用的标准字段（date、store、orders、amount），右边写上数据源可能出现的叫法（订单数 / 订单量 / 单量）。列名变了只改映射，不改计算逻辑。这是最省事、也最能扛数据源换系统的设计。

这是我每次导出的 CSV 表头（第一行）：（粘贴）
这是我脚本里想用的标准字段：date, store, orders, amount, refund

请帮我：
1. 写出列名映射表（标准字段 → 我在用的列名），标出哪些列没有对应；
2. 给出映射表的存放格式建议（写在代码里、还是单独一个 json），并说明理由；
3. 写一段校验：导出文件里如果少了一列或多了一列，分别在什么阶段报错、报什么 —— 我要在算指标之前就失败，而不是算完了才发现少列。

第三步：模板用占位符，一格一个，别用合并单元格

月报模板里，凡是要填数字的地方一律写成 {{orders_total}}，一个占位符只对应一个值。两个细节：占位符别放进合并单元格（替换后格式常被重置），也别跟文字混在一格（「共 {{n}} 单」这种替换后容易变成纯文本）。

这是我的月报模板结构：（哪些行哪些列放什么）

请帮我规划占位符命名，规则：
1. 格式统一为 {{指标名_维度}}，例如 {{orders_total}}、{{orders_by_store}}；
2. 一对一的值用一个占位符，需要循环展开的（各门店一行）单独标出来；
3. 指出我的模板里哪几处占位符放在合并单元格里，建议怎么改；
4. 给我一份「占位符 → 数据字段」对照表，我要贴给同事看。

第四步：脚本按「读、算、填、另存」四段写，中间落中间文件

四段之间用中间文件隔开：原始数据一份、算好的指标一份 JSON、填完的报表一份带日期的文件。出错时能定位在哪一段，也能只重跑后半段。填数那一段不要直接改模板，一律读模板、另存新文件。

请帮我写这个脚本的骨架（Python），只写结构和函数签名，不要写完整实现：

1. load_source(path) → DataFrame，负责读 CSV 并按映射表改名；
2. compute(df, month) → dict，按指标公式算出 8 个值，缺值按约定处理；
3. render(template_path, values, out_path) → 读模板、替换占位符、另存；
4. main() → 串起三段，任何一段失败就打印阶段名并以非 0 退出。

要求：中间结果落盘（原始数据、指标 JSON 各存一份）；文件名带年月；失败时不要删除已生成的文件，方便排查。

第五步：定时放在 2 号凌晨，先做三项自检再发出

不定 1 号，定 2 号凌晨：很多系统的当月数据要到 1 号白天才结算完，1 号跑出来的数一定是缺的。跑完自动做三项自检——有没有空值、环比波动是否超过 30%、文件名的年月对不对——三项都过才生成「可发送」的版本，否则只生成草稿并给你发一条提示。

这是我的定时设置想法：每月 2 号 02:00 跑。
这是上个月的指标数值：（列出）

请帮我：
1. 写三项自检的判断逻辑（空值、环比超过 ±30%、文件名年月与目标月是否一致）；
2. 说明这三项各自对应什么真实事故 —— 我需要知道漏掉哪一项会发出错数字；
3. 给出「自检不过」时的处理：是中止、还是生成草稿并标注哪一项没过，为什么这样选；
4. 定时任务用 Windows 计划任务和 cron 分别怎么写，各给一句。

实测记录

对象是一个 12 家门店的月度经营报表，8 个指标，数据从后台按自然月导出 CSV。手工流程 2 小时 30 分钟：整理数据 90 分钟、填表 40 分钟、复核与改格式 20 分钟。搭建自动化 3 小时：定口径 40 分钟、改模板 35 分钟、写脚本 80 分钟、调定时 25 分钟。之后每月 3 分钟生成、12 分钟复核。

第一次自动跑就出了两个错。一是日期：脚本用「当前月 – 1」算上月，1 月跑出来月份是 0，随后取数逻辑回退到了 11 月，整份报表数字全错——因为文件能正常生成，没人发现。二是空值：12 家门店里有 2 家当月没有数据，被 pandas 填成 0，客单价从 68 掉到 41，环比显示 -40%。加了空值检查和环比阈值之后，这两个问题都会在发出前被拦下。

第三个坑是覆盖：脚本直接往模板文件里写，第一次跑完模板就变成了填过的版本，第二次跑时占位符已经不存在，等于往上一期的数字上再填一遍。改成读模板另存之后解决。复核时间从 20 分钟降到 12 分钟，因为不用再逐格核对格式。

最容易错的 3 个地方

第一，用「减一」算上月。任何跨年的月份计算都不能直接减，1 月减 1 等于 0。要用日期库里的月份加减（Python 的 relativedelta、Excel 的 EOMONTH），并且用 1 月的日期专门测一次。这个错最阴的地方是它不报错，只是数字变了。

第二，空值被静默填成 0。缺数据和「确实是 0」是两件事：前者应该显示「—」，后者才是 0。一旦混了，客单价、人均这类比值型指标会莫名其妙掉一半，而你在表格里看不出异常。做法是所有指标计算前先统计空值行数，超过阈值就不出正式版。

第三，直接改模板文件。跑一次模板就被写脏，第二次要么占位符找不到、要么在旧数字上叠加。规则很简单：模板只读，输出永远另存，文件名带年月。这样也天然解决了「找不到上个月文件」的问题。

可复用的东西

指标四行写法：定义 / 公式（分子分母）/ 时间范围 / 缺值处理。8 个指标写一遍，以后换人接手也不用再吵口径。

列名映射表：标准字段 → 数据源实际列名，单独存成 json。数据源换系统时只改这一张表。

四段脚本结构：读、算、填、另存，中间各落一份文件。哪段错了一眼能看出来，也能只重跑后半段。

三项自检：空值、环比 ±30%、文件名年月。三项都过才出「可发送」版本，否则只出草稿加一条提示。

如果你也经常要做这件事，欢迎在评论区说说你的卡点和做法；也可以留言告诉我，你想看哪个岗位的哪件活怎么用 AI 拆。

admin 普通

收藏 海报 链接