前言
全网找了一番，用python创建和更新word(.docx)文档，还是 python-docx 包比较好用 。依赖
- Python 2.6, 2.7, 3.3, or 3.4
- lxml >= 2.3.2
安装模块
- 由于 python-docx 已经提交给 PyPI 仓库，所以可以使用 pip 安装，如下：
pip install python-docx如果同时安装了 python2 和 python3 那么 pip 可能不能用，可以使用 pip3 来安装，如下：1Copypip3 install python-docxCopy如果同时安装了 python2 和 python3 那么 pip 可能不能用，可以使用 pip3 来安装，如下：
pip3 install python-docx- python-docx 也可以使用 easy_install 来安装，如下：
easy_install python-docx- 如果不能使用 pip 和 easy_install ，可以在 PyPI 下载包、解压、运行 setup.py，如下：
tar xvzf python-docx-{version}.tar.gzcd python-docx-{version}python setup.py installpython-docx 还依赖 lxml 包 ，使用前2种方法会自动安装所需依赖包，第三种方法需要自己手动安装 。
处理word文档
新建文档类
首先新建一个空白文档类 Document ， 如下：from docx import Documentdocument = Document()编辑已存在的word文档
python-docx 不仅可以创建word文档，还可以编辑已存在的word文档 。其实吧，这玩意儿只能编辑已存在的word文档，之所以有个“创建空白文档”的功能，只不过是拷贝一份空白word文档到工作区间，再在空白文档上编辑，看起来似乎是“创建空白文档”罢了 。本质上还是编辑已存在的word文档，捂脸中…
打开一个word文档，编辑完后，一定要记得保存 。如果保存文件名和原文件名不一样，则会另存为一份word文档；若文件名一样 ， 则会不加提示的保存修改内容 。如下：
from docx import Documentdocument = Document('existing-document-file.docx')document.save('new-file-name.docx')新增段落
在word中 段落 是最常见的，创建段落 paragraph 的操作如下：paragraph = document.add_paragraph('这是个段落 。')在此段落之前插入一个段落，如下：
prior_paragraph = paragraph.insert_paragraph_before('这是前面的段落 。')新增标题
新增标题代码如下：document.add_heading('这是个标题')修改标题大小，有1-9种规格，如下：
document.add_heading('The role of dolphins', level=2)如果使用 level=0 ，则会新增一个带有下划线样式的标题 。
新增分页符
代码如下：document.add_page_break()新增表格
创建一个2行2列的表格 Table ， 如下：table = document.add_table(rows=2, cols=2)获取第一行第二列的单元格类，如下：
cell = table.cell(0, 1)写入数据，如下：
cell.text = '这是第一行第二列的单元格'不仅如此，还能以数组的形式获取整个行或列，如下：
row = table.rows[1]row.cells[0].text = '第二行第一列'row.cells[1].text = '第二行第二列'或循环操作，如下：
for row in table.rows:for cell in row.cells:print(cell.text)用 len() 方法获取行数或列数，如下：
row_count = len(table.rows)col_count = len(table.columns)增加行，如下：
row = table.add_row()设置表格样式 ， 如下：
table.style = 'LightShading-Accent1'插入图片
【docx怎么解密word文件 docx处理word文档】插入本地图片 ， 如下：document.add_picture('demo.png')默认情况下，图片大小往往不尽如人意，调整图片大小 ， 如下：
from docx.shared import Inchesdocument.add_picture('demo.png', width=Inches(1.0), height=Inches(1.0))若同时定义宽度和高度 ， 则图片会被拉伸或压缩到指定大?。蝗艚龆ㄒ蹇矶然蚋叨?，则图会自适应调整大小 。所以，建议仅定义宽度即可 。
段落操作
设置段落样式
设置段落样式，如下：document.add_paragraph('这是一个样式为 ListBullet 的段落', style='ListBullet')或
paragraph = document.add_paragraph('这是一个样式为 ListBullet 的段落')paragraph.style = 'List Bullet'设置段落对齐方式
段落对齐方式有 左对齐 、 文字居中 、 右对齐 、 文本两端对齐等 ， 更多对齐方式请移步 WD_ALIGN_PARAGRAPHfrom docx.enum.text import WD_ALIGN_PARAGRAPH# LEFT=>左对齐# CENTER=>文字居中# RIGHT=>右对齐# JUSTIFY=>文本两端对齐paragraph = document.add_paragraph("你说啥")paragraph_format = paragraph.paragraph_formatparagraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER设置段落缩进
设置段落缩进，可为负值，如下：from docx.shared import Inchesparagraph = document.add_paragraph("你说啥")paragraph_format = paragraph.paragraph_formatparagraph_format.left_indent = Inches(0.5)也可以设置首行缩进，如下：
paragraph_format.first_line_indent = Inches(-0.25)设置段落制表符
详情请移步 TabStops设置段落间距
分为 段前 和 段后 ，设置值用 Pt 单位是 磅，如下：paragraph_format.space_before = Pt(18)paragraph_format.space_after = Pt(12)设置段落行距
当行距为 最小值 和 固定值 时，设置值单位为 磅 ，需要用 Pt ；当行距为 多倍行距 时，设置值为数值，如下：from docx.shared import Length#SINGLE=>单倍行距（默认）#ONE_POINT_FIVE =>1.5倍行距#DOUBLE2=>倍行距#AT_LEAST=>最小值#EXACTLY=>固定值#MULTIPLE=>多倍行距paragraph.line_spacing_rule = WD_LINE_SPACING.EXACTLY #固定值paragraph_format.line_spacing = Pt(18) # 固定值18磅paragraph.line_spacing_rule = WD_LINE_SPACING.MULTIPLE #多倍行距paragraph_format.line_spacing = 1.75 # 1.75倍行间距设置段落分页
- 孤行控制
防止在页面顶端单独打印段落末行或在页面底端单独打印段落首行 。 - 与下段同页
防止在选中段落与后面一段间插入分页符 。 - 段中不分页
防止在段落中出现分页符 。 - 段前分页
在选中段落前插入分页符 。
#widow_control => 孤行控制#keep_with_next => 与下段同页#page_break_before => 段前分页#keep_together => 段中不分页paragraph_format.keep_with_next = True字体操作
设置粗体和斜体
在设置粗体和斜体之前，我们先简单了解一下 段落 里的运行机制 。段落包含很多块级的格式，比如缩进、行高、制表符等 。每一个小片段叫做一个 run ， 可以对 run 设置粗体和斜体等属性 。
我们可以设置如下：
paragraph = document.add_paragraph()paragraph.add_run('这是一个带有')paragraph.add_run('粗体').bold = Trueparagraph.add_run('和')paragraph.add_run('斜体').italic = Trueparagraph.add_run('的段落 。')设置字体属性
对 run 设置字体、大小、颜色下划线等，更多属性请移步 Font ，如下：
from docx.shared import RGBColor,Pt# all_caps => 全部大写字母# bold => 加粗# color => 字体颜色# complex_script => 是否为“复杂代码”# cs_bold => “复杂代码”加粗# cs_italic => “复杂代码”斜体# double_strike => 双删除线# emboss => 文本以凸出页面的方式出现# hidden => 隐藏# imprint => 印记# italic => 斜体# name => 字体# no_proof => 不验证语法错误# outline => 显示字符的轮廓# shadow => 阴影# small_caps => 小型大写字母# snap_to_grid => 定义文档网格时对齐网络# strike => 删除线# subscript => 下标# superscript => 上标# underline => 下划线paragraph = document.add_paragraph()paragraph.add_run('这是一个带有')paragraph.add_run('颜色').font.color.rgb = RGBColor(54, 95, 145)paragraph.add_run('的')paragraph.add_run('大字').font.size = Pt(36) # 字体大小设置，和word里面的字号相对应设置字符样式
除了设置段落样式外，还可以设置一组字符样式 ， 比如字体、大小、颜色、粗体、斜体等 ， 如下：
# 自定义样式 Emphasisparagraph = document.add_paragraph('这是一个带有')paragraph.add_run('自定义样式', 'Emphasis')paragraph.add_run('的段落')或
paragraph = document.add_paragraph('这是一个带有 ')run = paragraph.add_run('自定义样式')run.style = 'Emphasis'paragraph.add_run('的段落')页眉和页脚
更多内容请移步 Working with Headers and Footers
枚举的文档
- MSO_COLOR_TYPE
- MSO_THEME_COLOR_INDEX
- WD_PARAGRAPH_ALIGNMENT
- WD_BUILTIN_STYLE
- WD_CELL_VERTICAL_ALIGNMENT
- WD_COLOR_INDEX
- WD_LINE_SPACING
- WD_ORIENTATION
- WD_TABLE_ALIGNMENT
- WD_ROW_HEIGHT_RULE
- WD_SECTION_START
- WD_STYLE_TYPE
- WD_TAB_ALIGNMENT
- WD_TAB_LEADER
- WD_TABLE_DIRECTION
- WD_UNDERLINE