Python-docx 模塊讀寫 Word 文檔基礎：創建文檔、段落格式、字體格式設置方法

python-docx 模塊簡介：

安裝方法：pip install python-docx
官方文檔地址： python-docx 0.8.10
python-docx 模塊集成了 Word 文檔的讀寫功能，不像 python 的 xlwt 和 xlrd 模塊操作 Excel 表格，一個輔助寫，一個負責讀，用起來還是很方便的。

【Python與Word】專欄簡介：

本專欄也會分兩個部分來講解：基礎接口（用法）詳解，實例演練 。
基礎接口講解內容：
1、python-doxc模塊新建（寫） Word 文檔（預計兩篇博客）；
2、python-doxc模塊讀取 Word 文檔信息（預計一篇）。

本篇博客主要內容：

1、創建文檔與基礎操作；
2、文檔段落格式設置；
3、字體格式設置。

1、創建 Word 文檔及基礎用法：

模塊安裝后，導入模塊，新建 word 文檔對象：

# 導入模塊
from docx import Document

doc = Document()  # 新建文檔對象
'''按模板新建 word 文檔文件，具有模板文件的所有格式'''

新建了 Document 對象后就可以用它開始工作了：

# 增加標題：
doc.add_heading('標題',1)
'''
add_heading(self, text="", level=1):
'''

# 段落正文
par = doc.add_paragraph('第一個段落：')
print(par) 
# <docx.text.paragraph.Paragraph object at 0x000000000A889F08>
'''
add_paragraph(self, text='', style=None):
返回一個 Paragraph 段落對象
'''

# 在段落中添加文字
run_ = par.add_run('段落文字')
print(run_) 
# <docx.text.run.Run object at 0x000000000B2D31C8>
'''
add_run(self, text=None, style=None):
返回一個 run 對象
'''

解析：
以上代碼，在文檔中增加了一個標題、一個段落並在段落中增加了文字。以上三個方法都會返回相應的對象，以便后續的一些操作。

其他一些常用方法：（在文檔中增加圖片、表格）

# 增加圖片
pic_par = doc.add_picture('1.png')
'''
add_picture(self, image_path_or_stream, width=None, height=None):
返回一個 InlineShape 對象
'''
print(pic_par)  # <docx.shape.InlineShape object at 0x000000000B2F11C8>

# 增加表格
table = doc.add_table(2,3)
'''
add_table(self, rows, cols, style=None):
返回一個表格對象 
'''
print(table)  # <docx.table.Table object at 0x000000000B302688>

# 保存文件
doc.save('test.docx')

2、段落格式設置：

add_heading 方法：

# 增加分頁符
doc.add_page_break()

# 增加標題 API 分析
for i in range(0,10):
    exec ("doc.add_heading('標題%s',%s)" % (i,i))
# 只能設置 0-9 級標題

add_heading 方法：是在Word 文檔中增加標題，也就是Word文檔中的這些快捷窗口：

新建一個段落，並對段落格式進行設置：

1、段落文字對齊設置：

# 增加分頁
doc.add_page_break()

par2 = doc.add_paragraph('第二個段落文本:麻煩給我的愛人來一杯MojIto，'
                         '我喜歡閱讀她微醺時的眼眸，而我的咖啡，糖不用太多,'
                         '這世界已經因為她甜得過頭，沒有跟她笑容一樣濃郁的雪茄，'
                         '就別浪費時間介紹收起來吧，拱廊的壁畫，舊城的塗鴉，'
                         '所有色彩都因為她說不出話。')

# Paragraph 段落格式設置
# 段落對齊設置：# 導入對齊選項
from docx.enum.text import WD_ALIGN_PARAGRAPH

# 設置段落文本右對齊
par2.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.RIGHT
'''
可選項有：
'LEFT', 0, 'left', 'Left-aligned'
'CENTER', 1, 'center', 'Center-aligned.'
'RIGHT', 2, 'right', 'Right-aligned.'
'JUSTIFY', 3, 'both', 'Fully justified.'
'DISTRIBUTE', 4, 'distribute', 'Paragraph characters are distrib'
            'uted to fill the entire width of the paragraph.'
'JUSTIFY_MED', 5, 'mediumKashida', 'Justified with a medium char'
            'acter compression ratio.'
'JUSTIFY_HI', 7, 'highKashida', 'Justified with a high character'
            ' compression ratio.'
'JUSTIFY_LOW', 8, 'lowKashida', 'Justified with a low character '
            'compression ratio.'
'THAI_JUSTIFY', 9, 'thaiDistribute', 'Justified according to Tha'
            'i formatting layout.'
'''
# 獲取段落設置的對齊方式
print(par2.alignment)

2、段落縮進設置：

# 段落縮進：
# 導入縮進單位
from docx.shared import Inches,Pt
# 左縮進,0.5 英寸
par2.paragraph_format.left_indent = Inches(0.5)
# 右縮進,20 磅
par2.paragraph_format.right_indent = Pt(20)
# 首行縮進
par2.paragraph_format.first_line_indent = Inches(1)

3、段落間距設置：

# 行間距
# par2.paragraph_format.line_spacing = Pt(20) # 20 磅
par2.paragraph_format.line_spacing = 1.5 # 1.5倍行距 單倍行距 1.0
"當line_spacing設置為長度值時表示絕對距離，"
"設置為浮點數時表示行高的倍數"

# 段前間距
par2.paragraph_format.space_before = Pt(5)
# 段后間距
par2.paragraph_format.space_after = Pt(10)

# 設置段落內部文字在遇到需分頁情況時處理狀態
par2.paragraph_format.keep_together = True  # 段中不分頁
par2.paragraph_format.keep_with_next = True # 與下段同頁
par2.paragraph_format.page_break_before = True # 段前分頁
par2.paragraph_format.widow_control = True # 孤行控制

以上段落設置方法，其實對應Word文檔中的段落設置方法.

注：以上設置的段落格式，也均可獲取到設置值，如：

# 獲取段落的左縮進，首行縮進，段前間距：
l_space = par2.paragraph_format.left_indent
h_space = par2.paragraph_format.first_line_indent
b_space = par2.paragraph_format.space_before
print(l_space,h_space,b_space) 
# 打印結果
# 457200 914400 63500

4、字體格式設置：

首先明確一個概念：

python-docx 模塊中，paragraph 段落是一個塊對象，可以理解為是一個容器。run 對象也是一個塊對象，可以理解為具有相同格式的一段文字集合。

放在 word 文檔中簡單理解就是，一個段落包含許多文字，同一段落的文字，也可以有不同的格式。

注意：用 add_paragraph() 方法添加段落時，如果寫入了文本，就直接創建了一個 run。

測試一下上面的 paragraph 對象：

# 獲取上面段落對象 所有 run 對象
par2_run = par2.runs
print(par2_run) 
# 打印結果：
# [<docx.text.run.Run object at 0x000000000B307048>]

字體格式設置：

# 新建一個段落，增加一段文字
run_2 = doc.add_paragraph().add_run('這愛不落幕，忘了心事的國度，'
                                    '你所在之處，孤單都被征服，'
                                    '鐵鑄的招牌，錯落着就像，'
                                    '一封封城市獻給天空的情書，'
                                    '當街燈亮起，Havana漫步，'
                                    '這是世上最美麗的那雙人舞。')
# 設置字體格式
run_2.font.name = 'Times New Roman'  # 注：這個好像設置 run 中的西文字體
# 設置中文字體
# 需導入 qn 模塊
from docx.oxml.ns import qn
# run_2.font.name = '楷體'  # 注：如果想要設置中文字體，需在前面加上這一句
run_2.font.element.rPr.rFonts.set(qn('w:eastAsia'),'楷體')
# 設置字體大小
run_2.font.size = Pt(14)
# 設置加粗
run_2.font.bold = True
# 設置斜體
run_2.font.italic = True
# 設置字體顏色 需導入 rgb 顏色模塊
from docx.shared import RGBColor
run_2.font.color.rgb = RGBColor(255,55,55) # 紅色
# 設置下划線
# run_2.font.underline = True
# 設置輪廓線
# run_2.font.outline = True
# 設置陰影
# run_2.font.shadow = True
# 刪除線
# run_2.font.strike = True
# 雙刪除線
# run_2.font.double_strike = True
# 設置下標
# run_2.font.subscript = True
# 設置上標
# run_2.font.superscript = True

5、表格格式設置：

https://blog.csdn.net/zhouz92/article/details/107066709
https://blog.csdn.net/liaosen/article/details/121242200

轉載自：https://blog.csdn.net/zhouz92/article/details/107028727

Python操作xlsx表格
https://zhuanlan.zhihu.com/p/567826486