python如何將數(shù)據(jù)寫入docx的示例詳解

更新時(shí)間：2025年12月04日 09:46:31 作者：liliangcsdn

docx是經(jīng)常用到的文檔格式,經(jīng)常需要python批量生成docx文檔,本文將和大家詳細(xì)介紹一下如何用python寫文本到docx,并以仿宋_GB2312為例示例如何設(shè)置格式,感興趣的小伙伴可以了解下

1 添加段落示例

這里示例如何寫段落到docx文件。

from docx import Document
from docx.shared import Pt
from docx.shared import RGBColor

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 添加一個(gè)新的段落
paragraph = doc.add_paragraph('這是一個(gè)有特定格式的段落。')
# 設(shè)置字體、大小和顏色
run = paragraph.add_run('這是加粗和藍(lán)色的文本。')
run.bold = True
run.font.size = Pt(12)
run.font.color.rgb = RGBColor(0, 0, 255)

# 保存文檔
doc.save('formatted_text.docx')

2 設(shè)置字體示例

docx經(jīng)常需要設(shè)置中文字體、大小、顏色等，這里以仿宋_GB2312為例，示例設(shè)置過程。

2.1 默認(rèn)設(shè)置

以下是全文統(tǒng)一設(shè)置字體、大小的示例，這里設(shè)置段落字體為三號(hào)仿宋-GB2312。

from docx import Document
from docx.oxml.ns import qn
from docx.shared import Pt, RGBColor

document = Document()
document.add_paragraph('您好,我是aaaaa')
# 設(shè)置文檔默認(rèn)字體
document.styles['Normal'].font.name = '仿宋_GB2312'
document.styles['Normal']._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋_GB2312')
# 保存word文檔
document.save('bbb.docx')

2.2 段落設(shè)置

添加段落后設(shè)置字體、字號(hào)、加粗、對(duì)齊，這里設(shè)置段落字體為三號(hào)仿宋-GB2312。

from docx import Document
from docx.shared import Pt

# 創(chuàng)建文檔
doc = Document()

# 添加段落并設(shè)置字體
paragraph = doc.add_paragraph("這是三號(hào)仿宋-GB2312字體")

# 設(shè)置段落字體
run = paragraph.runs[0]
run.font.name = '仿宋_GB2312'  # 字體名稱
run._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋_GB2312')  # 處理中文字體
run.font.size = Pt(16)  # 三號(hào)對(duì)應(yīng)16磅

# 保存文檔
doc.save("示例文檔.docx")

3 完整設(shè)置示例

以下是完整版本的docx格式設(shè)置示例。

from docx import Document
from docx.shared import Pt, Inches
from docx.oxml.ns import qn
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()

# 設(shè)置文檔默認(rèn)字體
doc.styles['Normal'].font.name = '仿宋_GB2312'
doc.styles['Normal']._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋_GB2312')

# 添加標(biāo)題
title = doc.add_heading("文檔標(biāo)題", 0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

# 添加正文
paragraph = doc.add_paragraph()
run = paragraph.add_run("這是一段使用三號(hào)仿宋-GB2312字體的文本。")
run.font.name = '仿宋_GB2312'
run._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋_GB2312')
run.font.size = Pt(16)

doc.save("完整示例.docx")

Python高效操作Word：實(shí)用技巧與進(jìn)階方法

掌握Python對(duì)Word文檔的基本操作是進(jìn)一步深入學(xué)習(xí)的基礎(chǔ)。本節(jié)將介紹如何使用python-docx庫來創(chuàng)建新的Word文檔、讀取現(xiàn)有文檔的內(nèi)容，以及向文檔中寫入文本。

1. 創(chuàng)建Word文檔

使用python-docx創(chuàng)建一個(gè)新的Word文檔非常簡(jiǎn)單。以下代碼展示了如何創(chuàng)建一個(gè)新文檔并保存：

from docx import Document

# 創(chuàng)建一個(gè)新的Word文檔
doc = Document()
# 添加一個(gè)段落
doc.add_paragraph('這是一個(gè)新的段落。')
# 保存文檔
doc.save('new_document.docx')

2. 讀取Word文檔內(nèi)容

讀取現(xiàn)有Word文檔也是python-docx的一個(gè)重要功能。以下示例代碼展示了如何打開一個(gè)文檔并讀取其內(nèi)容：

from docx import Document

# 打開一個(gè)已存在的Word文檔
doc = Document('existing_document.docx')
# 遍歷文檔中的每個(gè)段落并打印
for para in doc.paragraphs:
    print(para.text)

3. 向Word文檔寫入文本

向Word文檔中寫入文本是一個(gè)常見需求。我們可以添加新的段落，甚至在現(xiàn)有段落中添加文本：

from docx import Document

# 打開一個(gè)已存在的Word文檔
doc = Document('existing_document.docx')
# 向文檔添加一個(gè)新的段落
doc.add_paragraph('這是一個(gè)新添加的段落。')
# 在第一個(gè)段落中添加文本
doc.paragraphs[0].add_run(' 這是添加到第一個(gè)段落的文本。')
# 保存文檔
doc.save('updated_document.docx')

4. 插入圖片和表格

python-docx不僅限于處理文本，還可以插入圖片和創(chuàng)建表格。以下是如何操作的示例：

from docx import Document
from docx.shared import Inches

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 插入圖片
doc.add_picture('example.jpg', width=Inches(2.0))

# 創(chuàng)建一個(gè)表格
table = doc.add_table(rows=2, cols=3)
table.cell(0, 0).text = '第一行，第一列'
table.cell(1, 2).text = '第二行，第三列'

# 保存文檔
doc.save('document_with_image_and_table.docx')

通過這些基本操作，我們可以實(shí)現(xiàn)對(duì)Word文檔的基礎(chǔ)控制和內(nèi)容管理。這為進(jìn)一步學(xué)習(xí)格式化、樣式處理以及高級(jí)功能打下了堅(jiān)實(shí)的基礎(chǔ)。

5.格式化和樣式處理

在Python中處理Word文檔時(shí)，除了基本的文本操作，格式化和樣式處理也是非常重要的方面。python-docx庫提供了豐富的功能來設(shè)置文本格式和段落樣式，使得文檔看起來更加專業(yè)和吸引人。以下將介紹如何使用這些功能。

1. 文本格式設(shè)置

在Word文檔中，我們經(jīng)常需要設(shè)置字體、大小和顏色等文本格式。以下代碼展示了如何對(duì)文檔中的文本進(jìn)行格式化：

from docx import Document
from docx.shared import Pt
from docx.shared import RGBColor

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 添加一個(gè)新的段落
paragraph = doc.add_paragraph('這是一個(gè)有特定格式的段落。')
# 設(shè)置字體、大小和顏色
run = paragraph.add_run('這是加粗和藍(lán)色的文本。')
run.bold = True
run.font.size = Pt(12)
run.font.color.rgb = RGBColor(0, 0, 255)

# 保存文檔
doc.save('formatted_text.docx')

2. 段落格式設(shè)置

除了文本格式，段落的格式化也同樣重要。這包括設(shè)置對(duì)齊方式、行距等：

from docx import Document
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.shared import Pt

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 添加一個(gè)新的段落
paragraph = doc.add_paragraph('這是一個(gè)居中對(duì)齊的段落。')
# 設(shè)置段落的對(duì)齊方式
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 設(shè)置段落的行距
paragraph.paragraph_format.line_spacing = Pt(18)

# 保存文檔
doc.save('paragraph_formatting.docx')

3. 列表和編號(hào)的應(yīng)用

在Word文檔中，列表和編號(hào)是常用來組織信息的工具。以下示例展示了如何創(chuàng)建有序和無序列表：

from docx import Document

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 添加一個(gè)無序列表
doc.add_paragraph('無序列表項(xiàng) 1', style='List Bullet')
doc.add_paragraph('無序列表項(xiàng) 2', style='List Bullet')

# 添加一個(gè)有序列表
doc.add_paragraph('有序列表項(xiàng) 1', style='List Number')
doc.add_paragraph('有序列表項(xiàng) 2', style='List Number')

# 保存文檔
doc.save('lists_in_document.docx')

4. 表格樣式和布局調(diào)整

python-docx還允許我們?cè)谖臋n中插入和格式化表格。以下代碼展示了如何創(chuàng)建一個(gè)表格并對(duì)其進(jìn)行樣式設(shè)置：

from docx import Document
from docx.shared import Inches
from docx.oxml import OxmlElement

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 創(chuàng)建一個(gè)表格
table = doc.add_table(rows=3, cols=3)
table.style = 'Table Grid'

# 合并單元格
a = table.cell(0, 0)
b = table.cell(0, 1)
a.merge(b)

# 設(shè)置單元格寬度
for row in table.rows:
    for cell in row.cells:
        cell.width = Inches(1.5)

# 添加文本到表格
for i in range(3):
    for j in range(3):
        table.cell(i, j).text = f'單元格 {i+1}, {j+1}'

# 保存文檔
doc.save('table_in_document.docx')

通過上述方法，可以使Word文檔的格式和樣式更加豐富和專業(yè)，大大提高文檔的整體質(zhì)量和閱讀體驗(yàn)。

6.高級(jí)功能：自動(dòng)化和腳本編寫

隨著對(duì)Python和Word交互的深入理解，我們可以開始探索一些更高級(jí)的功能，特別是自動(dòng)化和腳本編寫。這些功能能夠大大提高工作效率，尤其是在處理大量文檔或復(fù)雜文檔操作時(shí)。

1. 利用Python腳本批量處理Word文檔

在有大量類似Word文檔需要處理的情況下，批量處理變得尤為重要。以下示例展示了如何使用Python腳本來批量修改多個(gè)文檔：

import os
from docx import Document

# 定義要處理的文檔所在的文件夾
folder_path = 'path/to/documents'

# 遍歷文件夾中的所有Word文檔
for filename in os.listdir(folder_path):
    if filename.endswith('.docx'):
        doc_path = os.path.join(folder_path, filename)
        doc = Document(doc_path)

        # 在每個(gè)文檔中添加一個(gè)新的段落
        doc.add_paragraph('這是通過自動(dòng)化腳本添加的段落。')
        # 保存修改后的文檔
        doc.save(doc_path)

2. Word文檔中的數(shù)據(jù)提取和處理

在某些情況下，我們需要從Word文檔中提取特定數(shù)據(jù)。以下代碼示例展示了如何提取文檔中的文本并進(jìn)行處理：

from docx import Document

# 打開一個(gè)Word文檔
doc = Document('example.docx')

# 提取文檔中的文本
text = [para.text for para in doc.paragraphs]

# 對(duì)提取的文本進(jìn)行處理
# 例如：統(tǒng)計(jì)文檔的單詞數(shù)
word_count = sum(len(para.split()) for para in text)
print(f'文檔中的單詞數(shù)為：{word_count}')

3. 使用模板創(chuàng)建Word文檔

使用模板是創(chuàng)建具有一致格式文檔的有效方法?？梢灶A(yù)先創(chuàng)建一個(gè)包含所需格式和樣式的模板文檔，然后使用Python來填充具體內(nèi)容：

from docx import Document

# 打開模板文檔
template_doc = Document('template.docx')

# 向模板文檔中添加內(nèi)容
template_doc.add_paragraph('這是基于模板添加的內(nèi)容。')

# 保存為新的文檔
template_doc.save('new_document_from_template.docx')

4. 結(jié)合其他庫進(jìn)行數(shù)據(jù)分析與報(bào)告生成

Python的另一個(gè)強(qiáng)大之處在于其豐富的數(shù)據(jù)分析庫，如Pandas?？梢詫⑦@些庫與python-docx結(jié)合使用，從而實(shí)現(xiàn)數(shù)據(jù)分析和報(bào)告生成的自動(dòng)化：

import pandas as pd
from docx import Document

# 使用Pandas讀取數(shù)據(jù)
data = pd.read_csv('data.csv')

# 進(jìn)行數(shù)據(jù)分析
# 例如：計(jì)算數(shù)據(jù)的基本統(tǒng)計(jì)信息
summary = data.describe()

# 創(chuàng)建一個(gè)新的Word文檔
doc = Document()
doc.add_paragraph('數(shù)據(jù)分析報(bào)告')

# 將分析結(jié)果添加到Word文檔
doc.add_paragraph(str(summary))

# 保存文檔
doc.save('analysis_report.docx')

這些高級(jí)功能不僅能夠提高效率，還能夠?yàn)樘幚韽?fù)雜的文檔任務(wù)提供強(qiáng)大的支持。

7.特殊技巧：圖表、宏和交叉引用

在掌握了Python操作Word的基本和高級(jí)功能后，我們可以進(jìn)一步探索一些特殊技巧，如圖表的處理、宏的應(yīng)用，以及交叉引用的管理。這些技巧能夠使我們的文檔更加動(dòng)態(tài)和互動(dòng)。

1. 在Word文檔中插入和操作圖表

雖然python-docx庫本身不直接支持創(chuàng)建圖表，但我們可以通過插入圖片的方式來加入圖表。例如，可以使用如matplotlib這樣的圖表庫生成圖表，然后將其作為圖片插入到Word文檔中：

import matplotlib.pyplot as plt
from docx import Document
from docx.shared import Inches
import os

# 生成圖表
plt.figure()
plt.plot([1, 2, 3, 4])
plt.ylabel('一些數(shù)字')
plt.savefig('plot.png')

# 打開一個(gè)Word文檔
doc = Document()
# 將圖表作為圖片插入
doc.add_picture('plot.png', width=Inches(4.0))

# 清理臨時(shí)文件
os.remove('plot.png')

# 保存文檔
doc.save('document_with_chart.docx')

2. 利用宏進(jìn)行復(fù)雜操作

雖然Python不能直接在Word中創(chuàng)建或編輯宏，但可以操作包含宏的文檔。這意味著可以利用宏來執(zhí)行復(fù)雜的Word任務(wù)，而用Python來管理這些文檔：

from docx import Document

# 打開一個(gè)包含宏的Word文檔
doc = Document('macro_enabled_document.docm')

# 對(duì)文檔進(jìn)行操作（如添加文本）
doc.add_paragraph('這是一個(gè)包含宏的文檔。')

# 保存文檔
doc.save('macro_enabled_document_modified.docm')

3. 創(chuàng)建和管理文檔中的交叉引用和鏈接

python-docx也支持在文檔中創(chuàng)建和管理交叉引用和超鏈接。以下示例展示了如何添加超鏈接：

from docx import Document
from docx.oxml.shared import OxmlElement

# 打開或創(chuàng)建一個(gè)Word文檔
doc = Document()

# 添加一個(gè)含有超鏈接的段落
paragraph = doc.add_paragraph()
hyperlink = OxmlElement('w:hyperlink')
hyperlink.set('w:anchor', 'target_paragraph')
run = paragraph.add_run('點(diǎn)擊這里跳轉(zhuǎn)到目標(biāo)段落。')
run._r.append(hyperlink)

# 保存文檔
doc.save('document_with_hyperlinks.docx')

通過這些特殊技巧的應(yīng)用，可以使Word文檔更加豐富和動(dòng)態(tài)，提高文檔的可用性和互動(dòng)性。

8.錯(cuò)誤處理和性能優(yōu)化

在使用Python操作Word文檔的過程中，有效的錯(cuò)誤處理和性能優(yōu)化對(duì)于開發(fā)穩(wěn)定、高效的應(yīng)用程序至關(guān)重要。本節(jié)將討論在處理Word文檔時(shí)常見的一些錯(cuò)誤，以及如何優(yōu)化代碼的性能。

常見錯(cuò)誤及其解決方法

在使用python-docx等庫時(shí)，可能會(huì)遇到各種錯(cuò)誤。以下是一些常見錯(cuò)誤及其解決方法：

文件無法打開或找不到文件：確保文件路徑正確，文件沒有被其他程序鎖定。
無法解析文檔內(nèi)容：這可能是由于文檔格式不兼容。python-docx僅支持.docx格式的文檔。
修改后的文檔格式錯(cuò)亂：確保所有的格式設(shè)置正確，特別是在批量修改文檔時(shí)。

優(yōu)化代碼性能

處理大型文檔或大量文檔時(shí)，性能成為一個(gè)重要考慮。以下是一些優(yōu)化性能的策略：

批量處理優(yōu)化：在處理大量文檔時(shí)，考慮使用多線程或異步處理來提高效率。
內(nèi)存管理：處理大型文檔時(shí)，注意資源的管理。在處理完每個(gè)文檔后釋放內(nèi)存。
避免不必要的操作：比如，在循環(huán)內(nèi)部避免重復(fù)打開相同的文檔。

高效處理大型Word文檔

當(dāng)處理非常大的Word文檔時(shí)，以下技巧可能會(huì)有幫助：

分段處理：將大文檔分成多個(gè)部分處理，然后再合并。
使用流式讀?。喝绻赡?，使用流式讀取文檔內(nèi)容，避免一次性加載整個(gè)文檔到內(nèi)存。

通過有效的錯(cuò)誤處理和性能優(yōu)化，我們可以確保Python腳本在處理Word文檔時(shí)既穩(wěn)定又高效。

docx設(shè)置保存的word文檔字體及大小

from docx import Document
from docx.oxml.ns import qn
from docx.shared import Pt, RGBColor

document = Document()
document.add_paragraph('您好,我是aaaaa')
"""
設(shè)置正文字型
    英文字型:Times New Roman
    中文字型:宋體
"""
document.styles['Normal'].font.name = 'Times New Roman'
document.styles['Normal'].element.rPr.rFonts.set(qn('w:eastAsia'), u'宋體')
"""設(shè)置正文字體的大小"""
document.styles['Normal'].font.size = Pt(18)
"""設(shè)置正文字體顏色"""
document.styles['Normal'].font.color.rgb = RGBColor(0, 0, 0)
# 保存word文檔
document.save('bbb.docx')

注意，字體大小設(shè)置的單位為磅，不是像素，word中字體與磅值對(duì)比如下：