用python-docx拼接模板+pyodbc/sqlite3查数据可实现周报生成;关键在于模板结构可预测、占位符与数据库字段严格对应,占位符需用{xxx}格式置于普通段落且独占一行,配合字典驱动的lambda查询函数自动映射,注意异常处理、None转空字符串、日期格式化及模板纯净性。

直接用 python-docx 拼接模板 + pyodbc 或 sqlite3 查数据,就能跑通周报生成流程;关键不是“能不能做”,而是模板结构是否可预测、数据库字段和 Word 占位符是否对得上。
Word 模板里怎么写占位符才方便替换?
别用复杂样式或文本框——python-docx 无法可靠读取它们。只在普通段落里用清晰、唯一的标记,比如:
-
{last_week_sales}、{top_product}—— 全大写+下划线更易 grep,也避免和正文冲突 - 每个占位符独占一行,前后不留多余空格,否则替换后格式错乱
- 表格单元格里的占位符也一样处理,但注意:合并单元格可能被拆成多个
paragraph,要遍历cell.paragraphs - 如果需填多行内容(如本周事项列表),用
{weekly_tasks}占位,后续用paragraph.insert_paragraph_before()插入新段落,再删掉原占位符段落
查数据库时怎么让字段名和占位符自动对应?
硬编码映射容易漏、难维护。推荐用字典驱动替换逻辑:
data_map = {
"last_week_sales": lambda cur: str(cur.execute("SELECT SUM(amount) FROM sales WHERE week = ?;", (last_week,)).fetchone()[0]),
"top_product": lambda cur: cur.execute("SELECT name FROM products ORDER BY sold_count DESC LIMIT 1;").fetchone()[0],
}
这样每项都是一个可执行函数,查完即用,不依赖固定 SQL 结果顺序;调试时单独调用某个 lambda 就能验证数据源是否正常。
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- 所有数据库查询必须加异常捕获,
None值要转成空字符串,否则str(None)会写进 Word - 日期字段建议统一用
.strftime('%Y-%m-%d')格式化,避免数据库返回datetime对象导致str()输出带时分秒 - SQL Server 用
pyodbc时注意参数占位符是?,不是%s;SQLite 同理
生成后保存失败或格式全乱了怎么办?
常见原因不是代码错,而是 Word 模板本身“带病”:
- 模板文件不能是 .doc,必须是 .docx;用 Word 另存为「Word 文档(*.docx)」,不要选「兼容模式」
- 如果生成的文档打开提示“文件已损坏”,大概率是模板里有隐藏的
Content Control(开发工具里的控件),python-docx不支持,删掉再试 - 中文乱码通常因系统默认编码非 UTF-8,但
python-docx内部用 UTF-16 处理文本,所以只要 Python 字符串是正常 str 类型(不是 bytes),就不用额外 decode - 替换后段落缩进/字体变了?因为
paragraph.text = ...会清空原有格式;正确做法是遍历paragraph.runs,只改.text,保留.font和.paragraph_format
最麻烦的其实是模板变更——销售部门下周突然加一栏“客户满意度得分”,你得同步改 SQL、改 data_map、改 Word 占位符、还得重新测试所有分支逻辑。这类耦合点没法完全消除,只能靠命名规范和注释守住底线。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










