你已成功从 `qcc_data` 中提取了全部字段（假设数据干净、列存在、非空），现在要**将这些变量写入 Word 文档**，最常用、最灵活、且支持模板化的方案是： ✅ **使用 `docxtpl` 库（基于 python-docx 的模板引擎）** —— 支持 `{{variable}}` 占位符，自动渲染，无需手动排版，适合生成合同、报告、资质文件等。 --- ### ✅ 第一步：安装依赖（如未安装） ```bash pip install docxtpl ``` --- ### ✅ 第二步：准备一个 Word 模板（`.docx` 文件） 新建一个 `template.docx`，在任意位置写占位符（用双大括号）： ``` 企业英文名称：{{ supplier_en_name }} 统一社会信用代码：{{ supplier_uniform_social_credit_code }} 企业地址：{{ supplier_address }} 法定代表人：{{ legal_person }} 成立日期：{{ supplier_establishment_date }} 邮箱：{{ supplier_email_address }} 电话：{{ supplier_phone_number }} 企业规模：{{ supplier_enterprise_scale }} 经营状态：{{ supplier_operating_state }} 经营范围：{{ supplier_scope_of_business }} 注销时间：{{ supplier_logout_date }} ``` > ✅ 注意： > - 所有 `{{ xxx }}` 中的变量名必须与你 Python 中定义的**完全一致**（大小写、下划线）； > - `docxtpl` 会自动替换，保留原有格式（加粗、字体、段落等）； > - 模板中可自由添加表格、标题、页眉页脚，全部保留。 --- ### ✅ 第三步：Python 渲染并保存 Word ```python from docxtpl import DocxTemplate # ✅ 1. 加载模板 tpl = DocxTemplate("template.docx") # ✅ 2. 准备上下文字典（所有变量打包成 dict） context = { "supplier_en_name": supplier_en_name, "supplier_uniform_social_credit_code": supplier_uniform_social_credit_code, "supplier_address": supplier_address, "legal_person": legal_person, "supplier_establishment_date": str(supplier_establishment_date), # 防 datetime 格式报错，转 str "supplier_email_address": supplier_email_address, "supplier_phone_number": supplier_phone_number, "supplier_enterprise_scale": supplier_enterprise_scale, "supplier_operating_state": supplier_operating_state, "supplier_scope_of_business": supplier_scope_of_business, "supplier_logout_date": str(supplier_logout_date) if pd.notna(supplier_logout_date) else "", } # ✅ 3. 渲染并保存 tpl.render(context) tpl.save("供应商信息_{}.docx".format(supplier_name.strip())) print("✅ Word 文档已生成：供应商信息_{}.docx".format(supplier_name.strip())) ``` > ✅ 关键说明： > - `str(...)` 转换日期/时间类型，避免 `docxtpl` 不支持 `datetime` 报错； > - `pd.notna(...)` 仅对 `supplier_logout_date` 做空值兜底（按你要求“不考虑格式”，但日期空值仍需防崩）； > - 输出文件名含 `supplier_name`，便于区分。 --- ### ✅ 进阶技巧（按需选用） | 需求 | 实现方式 | |------|----------| | **多行内容自动换行/保留段落** | 在模板中直接写 `{{ supplier_scope_of_business }}`，`docxtpl` 自动处理换行符 `\n` → Word 段落 | | **空值显示“暂无”而非空白** | 模板中写 `{{ supplier_logout_date or "暂无" }}`（Jinja2 语法） | | **电话/邮箱超长时截断** | 模板中写 `{{ supplier_phone_number[:20] + '...' if supplier_phone_number|length > 20 else supplier_phone_number }}` | | **导出为 PDF（需额外工具）** | 先生成 `.docx`，再用 `pandoc` 或 `win32com`（Windows）转 PDF | --- ### ❌ 不推荐的手动方式（python-docx 原生） 虽然可行，但需逐段创建、设置样式、处理换行、管理表格——**代码量翻5倍+易出错+无法复用模板**，仅当必须动态生成复杂结构（如每行一个供应商）时才用。 --- ### 🔍 快速验证是否成功？ 运行后打开生成的 `.docx`，检查： - 所有 `{{xxx}}` 是否被真实值替换； - 中文、分号、日期是否显示正常； - 特殊字符（如 `&`, `<`, `>`）是否未被转义（`docxtpl` 默认安全，无需额外处理）。 ---