bwkyd Word 文档生成器
使用 python-docx 生成各类规范的中文 .docx 文档，兼容 WPS Office 和 Microsoft Word。
When to Use
- 用户需要生成 Word/docx 文档
- 用户需要创建合同、报告、简历、论文、方案等
- 用户需要批量生成文档或填充模板
- 用户说"帮我写一份XX"且不是公文场景
When NOT to Use
- 党政机关公文 → 使用
wps-gongwen - WPS宏脚本开发 → 使用
wps-jsa-macro - 纯文本/Markdown文档 → 直接编写
支持的文档类型
| 类型 | 典型场景 | 模板特征 |
|---|---|---|
| 合同/协议 | 劳动合同、租赁合同、保密协议、合作协议 | 甲乙方信息、条款编号、签章区 |
| 报告 | 工作报告、调研报告、分析报告、可行性报告 | 封面、目录、章节标题、图表 |
| 简历 | 中式求职简历 | 照片位、个人信息表、工作经历 |
| 方案/计划 | 项目方案、实施计划、营销方案 | 背景、目标、步骤、预算 |
| 论文 | 毕业论文、学术论文 | 封面、摘要、关键词、参考文献 |
| 信函 | 商业函件、邀请函、感谢信 | 抬头、正文、落款 |
| 表格文档 | 考勤表、登记表、审批表 | 多列表格、合并单元格 |
工作流程
Step 1: 需求确认
确认以下信息：
- 文档类型：合同/报告/简历/方案/论文/信函/其他
- 主要内容：核心内容描述
- 特殊要求：页面方向、字体偏好、是否需要封面/目录等
Step 2: 内容撰写
根据文档类型撰写内容，遵循中文商务/学术写作规范。
Step 3: 生成 .docx 文件
先确保依赖已安装：
pip install python-docx 2>/dev/null || pip3 install python-docx 2>/dev/null
使用以下核心代码框架：
from docx import Document
from docx.shared import Pt, Mm, Cm, Inches, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT
from docx.enum.section import WD_ORIENT
from docx.oxml.ns import qn, nsdecls
from docx.oxml import parse_xml
import os
class DocxWriter:
"""通用中文docx文档生成器"""
# 预置样式
STYLES = {
'title': {'font': '方正小标宋简体', 'size': 22, 'bold': True, 'align': 'CENTER'},
'heading1': {'font': '黑体', 'size': 18, 'bold': True, 'align': 'LEFT'},
'heading2': {'font': '黑体', 'size': 16, 'bold': True, 'align': 'LEFT'},
'heading3': {'font': '黑体', 'size': 14, 'bold': True, 'align': 'LEFT'},
'body': {'font': '仿宋_GB2312', 'size': 12, 'bold': False, 'align': 'JUSTIFY'},
'body_song':{'font': '宋体', 'size': 12, 'bold': False, 'align': 'JUSTIFY'},
'small': {'font': '宋体', 'size': 10.5,'bold': False, 'align': 'LEFT'},
'footer': {'font': '宋体', 'size': 9, 'bold': False, 'align': 'CENTER'},
}
def __init__(self, page='A4', orientation='portrait', margins=None):
self.doc = Document()
section = self.doc.sections[0]
# 页面设置
if orientation == 'landscape':
section.orientation = WD_ORIENT.LANDSCAPE
section.page_width = Mm(297)
section.page_height = Mm(210)
else:
section.page_width = Mm(210)
section.page_height = Mm(297)
# 边距（默认普通边距）
m = margins or {'top': 25.4, 'bottom': 25.4, 'left': 31.8, 'right': 31.8}
section.top_margin = Mm(m['top'])
section.bottom_margin = Mm(m['bottom'])
section.left_margin = Mm(m['left'])
section.right_margin = Mm(m['right'])
def add_text(self, text, style='body', space_before=0, space_after=0,
first_indent=None, line_spacing=None, color=None):
"""添加格式化段落"""
s = self.STYLES.get(style, self.STYLES['body'])
p = self.doc.add_paragraph()
p.alignment = getattr(WD_ALIGN_PARAGRAPH, s['align'])
p.paragraph_format.space_before = Pt(space_before)
p.paragraph_format.space_after = Pt(space_after)
if line_spacing:
p.paragraph_format.line_spacing = Pt(line_spacing)
if first_indent is not None:
p.paragraph_format.first_line_indent = Pt(first_indent)
elif style == 'body' or style == 'body_song':
p.paragraph_format.first_line_indent = Pt(s['size'] * 2)
run = p.add_run(text)
run.font.size = Pt(s['size'])
run.font.name = s['font']
run._element.rPr.rFonts.set(qn('w:eastAsia'), s['font'])
run.bold = s['bold']
if color:
run.font.color.rgb = RGBColor(*color)
return p
def add_table(self, headers, rows, col_widths=None, style='Table Grid'):
"""添加表格"""
table = self.doc.add_table(rows=1 + len(rows), cols=len(headers), style=style)
table.alignment = WD_TABLE_ALIGNMENT.CENTER
# 表头
for i, header in enumerate(headers):
cell = table.rows[0].cells[i]
cell.text = header
for paragraph in cell.paragraphs:
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
for run in paragraph.runs:
run.bold = True
run.font.size = Pt(10.5)
run.font.name = '黑体'
run._element.rPr.rFonts.set(qn('w:eastAsia'), '黑体')
# 数据行
for r_idx, row_data in enumerate(rows):
for c_idx, cell_text in enumerate(row_data):
cell = table.rows[r_idx + 1].cells[c_idx]
cell.text = str(cell_text)
for paragraph in cell.paragraphs:
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
for run in paragraph.runs:
run.font.size = Pt(10.5)
run.font.name = '宋体'
run._element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')
# 列宽
if col_widths:
for i, width in enumerate(col_widths):
for row in table.rows:
row.cells[i].width = Mm(width)
return table
def add_page_break(self):
"""添加分页符"""
self.doc.add_page_break()
def add_cover(self, title, subtitle=None, org=None, date_str=None):
"""添加封面页"""
# 上方留白
for _ in range(6):
self.doc.add_paragraph()
self.add_text(title, 'title', space_after=20)
if subtitle:
self.add_text(subtitle, 'heading1', space_after=40)
if org:
self.add_text(org, 'heading2', space_after=10)
if date_str:
self.add_text(date_str, 'heading2')
self.add_page_break()
def add_toc_placeholder(self):
"""添加目录占位（需在WPS中更新域）"""
p = self.doc.add_paragraph()
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
run = p.add_run('目 录')
run.font.size = Pt(22)
run.font.name = '黑体'
run._element.rPr.rFonts.set(qn('w:eastAsia'), '黑体')
run.bold = True
p2 = self.doc.add_paragraph()
p2.alignment = WD_ALIGN_PARAGRAPH.CENTER
run2 = p2.add_run('（请在WPS中右键此处 → 更新域 → 更新整个目录）')
run2.font.size = Pt(10.5)
run2.font.name = '宋体'
run2._element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')
run2.font.color.rgb = RGBColor(0x99, 0x99, 0x99)
self.add_page_break()
def save(self, filename):
"""保存文档"""
self.doc.save(filename)
return os.path.abspath(filename)
Step 4: 各文档类型具体指引
合同/协议
结构：
合同编号
合同标题
甲乙方信息（名称、地址、法定代表人、联系方式）
鉴于条款（背景）
正文条款（逐条编号）
违约责任
争议解决（仲裁/诉讼、管辖地）
其他约定
签署栏（甲方签章、乙方签章、日期）
注意：
- 条款编号使用"第X条"格式
- 金额须同时标注大小写
- 日期格式：XXXX年XX月XX日
- 签署栏左右分列（甲方左、乙方右）
报告
结构：
封面（标题、编制单位、日期）
目录
正文章节（一、二、三…）
结论/建议
附件/附录
注意：
- 章节标题层级清晰
- 数据用表格或列表呈现
- 图表需编号和标题
简历（中式）
结构：
标题栏（姓名、照片位）
基本信息表（性别、出生年月、民族、政治面貌、籍贯、学历、联系方式）
求职意向
教育背景
工作经历
项目经验
技能特长
自我评价
注意：
- 照片位右上角 35mm×45mm
- 基本信息用表格排列
- 控制在1-2页
Step 5: 交付
- 生成 .docx 文件
- 告知文件路径和大小
- 提示用WPS打开检查
- 按需调整
示例
# 生成一份劳动合同
/wps-docx-writer 合同 生成一份劳动合同，甲方为XX科技有限公司，合同期限3年
# 生成一份带封面的项目报告
/wps-docx-writer 报告 编写一份2026年Q1项目进度报告，需要封面和目录
# 生成一份中式简历
/wps-docx-writer 简历 生成一份软件工程师求职简历模板
输出：在当前目录生成对应的 .docx 文件，用WPS打开即可编辑。
格式参考
中文排版通用规范见 ../shared/chinese-typesetting.md。 python-docx 高级用法见 reference/python-docx-advanced.md。