python-docx

基础使用

1.创建一个document文档对象

from docx import Document
document = Document()

2.向文档中添加段落

添加一段话：

paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')
（调用后会返回一个Paragraphs段落对象的引用）

可将上面返回的对象作为一个游标，在已有段落之前加入：

prior_paragraph = paragraph.insert_paragraph_before('Lorem ipsum')

3.添加标题

默认为top-level标题

document.add_heading('The REAL meaning of the universe')

可由level参数指定标题级别

document.add_heading('The role of dolphins', level=2)

4.添加分页符

document.add_page_break()

5.添加列表

table = document.add_table(rows=2, cols=2)
（返回一个Tables对象）

还可对Tables对象中的单元格cell进行操作：

cell = table.cell(0, 1)

向其中添加内容：

cell.text = 'parrot, possibly dead'

还可以一行行的操作：

row = table.rows[1]
row.cells[0].text = 'Foo bar to you.'
row.cells[1].text = 'And a hearty foo bar to you too sir!'

并且rows和columns是可迭代的，例如：

for row in table.rows:
    for cell in row.cells:
        print(cell.text)

用len() 查询rows或columns的个数:

row_count = len(table.rows)
col_count = len(table.columns)

继续添加行：

row = table.add_row()

对于变长的表格，可以这样做：

# get table data -------------
items = (
    (7, '1024', 'Plush kittens'),
    (3, '2042', 'Furbees'),
    (1, '1288', 'French Poodle Collars, Deluxe'),
)

# add table ------------------
table = document.add_table(1, 3)

# populate header row --------
heading_cells = table.rows[0].cells
heading_cells[0].text = 'Qty'
heading_cells[1].text = 'SKU'
heading_cells[2].text = 'Description'

# add a data row for each item
for item in items:
    cells = table.add_row().cells
    cells[0].text = str(item.qty)
    cells[1].text = item.sku
    cells[2].text = item.desc

设定表格样式风格：

table.style = 'LightShading-Accent1'

6.添加图片

document.add_picture('image-filename.png')

图片大小，可直接设定宽高：

from docx.shared import Inches
document.add_picture('image-filename.png',width=Inches(1.0))

7.设置段落风格

可在创建paragraph时设定：

document.add_paragraph('Lorem ipsum dolor sit amet.', style='ListBullet')

也可之后设定：

paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')
paragraph.style = 'List Bullet'

8.使用加粗和倾斜

在通过add_paragraph()添加一段文字之后，还可以在这段中添加更多文字，通过add_run()

paragraph = document.add_paragraph('Lorem ipsum ')
paragraph.add_run('dolor sit amet.')
(这个方法会返回一个Run对象)

可对Run对象设定是否加粗、倾斜

paragraph.add_run('dolor').bold = True

is equivalent to:

run = paragraph.add_run('dolor')
run.bold = True

9.设定字体样式

paragraph = document.add_paragraph('Normal text, ')
paragraph.add_run('text with emphasis.', 'Emphasis')

is equivalent to:

paragraph = document.add_paragraph('Normal text, ')
run = paragraph.add_run('text with emphasis.')
run.style = 'Emphasis'