成果示例
把 9 家门店的月度销售文件合并成一份 Excel 报表
如何运行
python merge_sales.py --month 2026-10
2026-11-02 09:14:03 INFO 文件夹：sales/2026-10，找到 9 个文件
2026-11-02 09:14:03 INFO shop-01.csv：1,284 行
2026-11-02 09:14:04 INFO shop-02.xlsx：967 行
2026-11-02 09:14:04 WARN shop-07.csv：跳过 3 行缺少价格的记录（第 88、412、913 行）
2026-11-02 09:14:05 INFO 完成：10,412 行 -> report-2026-10.xlsx（工作表“销售”和“汇总”）
改设置，不改代码
每家门店的列名都写在 settings.ini 中，所以新增一家门店或某列改了名，只需在那里改一行：
[columns]
date = 日期, 销售日期, 日
product = 商品, 品名, 名称
quantity = 数量, 件数, 个数
price = 价格, 单价
部分代码
def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
"""读取一家门店的文件，并把列名改为报表使用的列名。"""
table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
renamed = {}
for name, variants in columns.items():
found = next((c for c in table.columns if c.strip() in variants), None)
if found is None:
raise ReportError(f"{path.name}：找不到“{name}”对应的列（已查找 {', '.join(variants)}）")
renamed[found] = name
table = table.rename(columns=renamed)[list(columns)]
table["shop"] = path.stem
return table
**文件：**一个 ZIP 压缩包，内含 merge_sales.py（310 行）、settings.ini、requirements.txt 和 README，说明如何安装 Python、运行脚本以及日志中每条消息的含义。客户在自己的电脑上运行。
**客户：**一家拥有 9 家门店的小型文具连锁店；每家门店每月以 CSV 或 Excel 文件发送当月销售数据，各自的列名略有不同。 **任务：**一个脚本，读取文件夹中的所有文件，把各列统一成同一格式，并生成一份 Excel 报表，包含全部销售记录和一张按门店汇总的工作表。
客户及所有信息均为虚构。
服务介绍
餐厅的桌卡、库存或设备标签、门票、商品吊牌、商品目录每一页的二维码：当您需要几百个二维码时，在网站上一个个生成要花很久。这个 Python 脚本读取您的名单（CSV 或 Excel），为每一行生成一个二维码：链接、文字、联系人名片或 Wi-Fi 信息，保存为适合屏幕的 PNG 或适合印刷的 SVG，并按某一列命名，例如桌号或 SKU。从标准版起，它会加上说明文字，并检查每个二维码能否被正确读回；高级版会把它们排到一张 PDF 标签纸上。这些是静态二维码：链接就在码里，所以印出来后无法修改，扫码次数也无法统计。大量印刷前请先扫几个试试。
服务内容
- 您将获得一个 ZIP 压缩包，内含 Python 脚本、附分步说明的 README，从标准版起还包含写有尺寸、颜色和说明文字的设置文件；订单页面上也能查看代码。
- 每行一个码链接、文字、联系人名片或 Wi-Fi 信息
- 屏幕或印刷按您设定尺寸的 PNG，或可任意缩放的 SVG
- 按您的方式命名文件按名单中的某一列命名
- 读回检查从标准版起，逐个解码每个二维码，确认内容一致
- 代码易读附有注释，以后修改样式很方便
服务流程
- 1名单您发来名单示例，并说明二维码的用途
- 2代码我们编写脚本和运行说明
- 3试用您先为几行生成二维码，并用手机扫一扫
- 4修改您在套餐范围内提出修改，如有报错信息请一并发来
需要您提供的信息
名单的 10 到 20 行，CSV 或 Excel 格式，哪一列放进二维码、哪一列用作文件名或说明文字，以及二维码用在哪里：屏幕、贴纸、卡片还是标牌，如果知道印刷尺寸也请告诉我们。如果不是白底黑码，请提供颜色；高级版请提供 PNG 或 SVG 格式的标志，以及标签纸的版式（纸张尺寸、每行每列各放几个码）。您的系统：Windows、macOS 还是 Linux。
我们会询问您：
- 这些二维码用来做什么？
- 每个码里放什么？
- 屏幕还是印刷？什么尺寸？
套餐对比
付款保障
您在下单时付款，但款项仅在您验收后才会结算。
- 固定价格付款后套餐价格不会变动。
- 款项先冻结付款时，这笔金额只是被冻结。您验收后，款项才会结算给平台。
- 交付前检查每份成果在送达您之前都会经过质量检查，验收前您可以在订单页面查看。
- 免费修改在需求说明范围内，您可以在套餐允许的次数内提出修改。
- 3 天后自动验收如果交付后 3 天内您既未验收也未提出修改，工作将自动验收。如果您在交付后于订单聊天中留言，订单将暂停自动验收；我们回复后，可能会重新开始计算 3 天，并会在聊天中告知您。
- 返工或全额退款如果成果与您的需求说明不符且修改后仍未解决，或工作耗时超过交付期限的两倍，请在订单聊天中留言：我们将为您返工或全额退款。
问题与解答
印出来后还能改二维码指向的地址吗？
这类二维码不行：地址就在码里。如果以后可能需要更改，请让二维码指向您自己网站上的页面，以后再给这些页面设置重定向。
能统计有多少人扫了码吗？
不能，统计需要在二维码和页面之间有一台服务器，而这个脚本没有。您可以给链接加上 UTM 参数，在您网站的分析工具中查看访问量。
在中间放标志安全吗？
二维码采用高纠错级别时，小标志没问题，高级版会设置好这一点。读回检查和用手机实际扫码，能让您确定是否可用。
能生成多少个二维码？
有多少行就能生成多少个；在普通电脑上，几千个只需一两分钟。
没有找到答案？