Python用Spire.Doc设置Word背景色与背景图片

脚本专家

需求与实现思路
在办公自动化场景中，批量美化 Word 文档是高频需求。手动逐份设置背景颜色、添加背景图片耗时且容易遗漏。本文使用 Free Spire.Doc for Python 免费 Word 处理库，实现两类功能：为 .docx 文档设置纯色背景，以及添加自定义背景图片。该库可通过 pip 安装，兼容 Windows、Mac、Linux。核心逻辑只有两步：获取文档的 Background 对象，再把 Type 指定为 Color 或 Picture，然后设置颜色或图片。

环境准备
安装依赖：

2. pip install spire.doc.free

复制代码

安装后导入模块：

2. from spire.doc import *
3. from spire.doc.common import *

复制代码

无需额外配置。

为 Word 设置纯色背景
完整代码：

2. from spire.doc import *
3. from spire.doc.common import *
5. document = Document()
6. document.LoadFromFile('Sample.docx')
7. background = document.Background
8. background.Type = BackgroundType.Color
9. background.Color = Color.get_AliceBlue()
10. document.SaveToFile('AddBackgroundColor.docx', FileFormat.Docx2016)
11. document.Close()

复制代码

代码核心解析：
1. Document() 初始化文档对象，LoadFromFile('Sample.docx') 加载本地待处理 Word 文档，支持绝对路径和相对路径。
2. document.Background 获取背景对象，background.Type = BackgroundType.Color 将背景模式切换为纯色模式，覆盖默认空白背景。
3. background.Color = Color.get_AliceBlue() 设置爱丽丝蓝；库中提供数十种内置颜色参数，也支持自定义 RGB 颜色值。
4. SaveToFile('AddBackgroundColor.docx', FileFormat.Docx2016) 保存为 2016 版 docx 格式。
5. document.Close() 必须调用，用于释放资源，避免文档进程占用、内存溢出等问题。

为 Word 设置背景图片
完整代码：

2. from spire.doc import *
3. from spire.doc.common import *
5. document = Document()
6. document.LoadFromFile('Sample.docx')
7. background = document.Background
8. background.Type = BackgroundType.Picture
9. background.SetPicture('background.jpg')
10. document.SaveToFile('AddBackgroundPicture.docx', FileFormat.Docx2016)
11. document.Close()

复制代码

关键注意事项：
1. background.SetPicture('background.jpg') 用于加载本地图片并作为全局背景。图片会自动适配文档页面尺寸，铺满整篇文档，适合海报、公文、模板文档等美化场景。
2. 该方法支持相对路径和绝对路径。建议将图片与代码文件放在同一目录，避免路径报错。
3. 图片格式兼容 jpg、png、bmp 等主流格式，无需额外转换。
4. 设置图片背景后会自动覆盖原有纯色背景，不需要手动清空旧背景样式。

常见问题与优化建议
1. 文档路径报错：若提示文件找不到，优先检查路径。可改用绝对路径，例如 document.LoadFromFile('C:/Users/xxx/Desktop/Sample.docx')。
2. 自定义任意颜色：除内置颜色外，可以通过 RGB 自定义背景色，例如 background.Color = Color(240, 248, 255)，适配自定义配色需求。
3. 批量处理文档：可结合 os 模块遍历文件夹下所有 docx 文件，循环执行背景设置代码，实现批量文档一键美化，提升办公效率。批量处理时同样要注意每个文档执行 Close() 释放资源。

总结
借助 Free Spire.Doc for Python，仅需十余行代码即可实现 Word 文档背景美化。核心流程是获取 Background 对象，指定 BackgroundType.Color 或 BackgroundType.Picture，再设置颜色或调用 SetPicture()。该方案轻量化、依赖少，适合个人办公、批量文档处理和自动化模板生成，代码可直接复用并二次开发。