前言

对于自动化RPA比较火热，相应的库也比较多，此文分析win32com这个库，用于操作office

1. 基本知识

Win32com 是一个 Python 模块，是 pywin32 扩展的一部分，允许 Python 代码与 Windows COM（Component Object Model）对象进行交互

COM 是 Windows 平台上用于组件软件模型的技术，可以让不同的应用程序通过 COM 对象进行通信和操作

基本的API如下：

1. Dispatch 函数用于创建一个 COM 对象的实例
   通过对象的 ProgID 来初始化 COM 对象

import win32com.client
excel = win32com.client.Dispatch("Excel.Application")

2. GetActiveObject 函数用于连接到已经运行的 COM 对象
   通过对象的 ProgID 来连接到现有的 COM 对象实例

word = win32com.client.GetActiveObject("Word.Application")

3. DispatchEx 类似于 Dispatch，但允许在不同的安全上下文中创建 COM 对象

excel = win32com.client.DispatchEx("Excel.Application")

4. EnsureDispatch 函数与 Dispatch 类似，但如果无法创建对象，则会抛出更友好的异常

excel = win32com.client.gencache.EnsureDispatch("Excel.Application")

5. WithEvents 函数用于绑定事件处理程序到 COM 对象

class ExcelEvents:def OnWorkbookOpen(self, wb):print("Workbook opened:", wb.Name)excel = win32com.client.DispatchWithEvents("Excel.Application", ExcelEvents)

2. Excel

基本的Demo如下：
展示了如何使用 win32com 控制 Excel 应用程序，创建一个新工作簿，并向单元格中写入数据

import win32com.clientdef main():# 创建 Excel 应用程序实例excel = win32com.client.Dispatch("Excel.Application")excel.Visible = True  # 使 Excel 界面可见# 创建一个新的工作簿workbook = excel.Workbooks.Add()sheet = workbook.Worksheets(1)# 向单元格中写入数据sheet.Cells(1, 1).Value = "Hello"sheet.Cells(1, 2).Value = "World"sheet.Cells(2, 1).Value = "Python"sheet.Cells(2, 2).Value = "Win32com"# 保存工作簿workbook.SaveAs(r"d:\Users\lixiaosong\ceshi.xlsx")# 关闭工作簿workbook.Close(False)  # False 表示不保存# 退出 Excel 应用程序excel.Quit()if __name__ == "__main__":main()

截图如下：

对于上述的Demo，基本函数用法如下：

1. 创建 Excel 应用程序实例：excel = win32com.client.Dispatch("Excel.Application")
2. 使 Excel 界面可见：excel.Visible = True
3. 创建一个新的工作簿：workbook = excel.Workbooks.Add()
4. 选择第一个工作表：sheet = workbook.Worksheets(1)
5. 向单元格中写入数据
6. 保存工作簿：workbook.SaveAs(r"C:\path\to\your\file.xlsx")
7. 退出 Excel 应用程序：excel.Quit()

3. Word

import win32com.clientdef main():# 创建 Word 应用程序实例word = win32com.client.Dispatch("Word.Application")word.Visible = True  # 使 Word 界面可见# 创建一个新的文档doc = word.Documents.Add()# 向文档中写入文本range_obj = doc.Range(0, 0)range_obj.Text = "Hello World!\n"range_obj.InsertAfter("This is a demo of win32com in Python.\n")range_obj.InsertAfter("You can automate Word operations using Python scripts.\n")# 保存文档doc.SaveAs(r"d:\Users\lixiaosong\file.docx")# 关闭文档doc.Close(False)  # False 表示不保存# 退出 Word 应用程序word.Quit()if __name__ == "__main__":main()

截图如下：

对于上述的Demo，基本函数用法如下：

1. 创建 Word 应用程序实例：word = win32com.client.Dispatch("Word.Application")

2. 使 Word 界面可见：word.Visible = True

3. 创建一个新的文档：doc = word.Documents.Add()

4. 向文档中写入文本

5. 保存文档：doc.SaveAs(r"C:\path\to\your\file.docx")

6. 关闭文档：doc.Close(False)

7. 退出 Word 应用程序：word.Quit()

以上的Demo比较简易，如果想花里胡哨还可使用如下：

• 插入段落：

paragraph = doc.Paragraphs.Add()
paragraph.Range.Text = "This is a new paragraph."

• 设置文本格式：

range_obj.Font.Name = "Arial"
range_obj.Font.Size = 12
range_obj.Font.Bold = True
range_obj.Font.Italic = True

• 插入表格：

table = doc.Tables.Add(range_obj, 3, 3)
table.Cell(1, 1).Range.Text = "Row 1, Col 1"
table.Cell(1, 2).Range.Text = "Row 1, Col 2"
table.Cell(1, 3).Range.Text = "Row 1, Col 3"

• 正文文字替换：

find = doc.Content.Find
find.Text = "old text"
find.Replacement.Text = "new text"
find.Execute(Replace=2)

• 页眉页脚文字替换:

header_range = doc.Sections(1).Headers(win32com.client.constants.wdHeaderFooterPrimary).Range
header_find = header_range.Find
header_find.Text = "old header text"
header_find.Replacement.Text = "new header text"
header_find.Execute(Replace=2)

• 打印文档：doc.PrintOut()

更多的Demo如下：

1. 正文文字替换：

import win32com.clientdef main():word = win32com.client.Dispatch("Word.Application")word.Visible = True# 打开一个现有的文档doc = word.Documents.Open(r"C:\path\to\your\file.docx")# 进行文字替换find = doc.Content.Findfind.Text = "old text"find.Replacement.Text = "new text"find.Execute(Replace=2)  # 2 表示 wdReplaceAll# 保存并关闭文档doc.Save()doc.Close(False)word.Quit()if __name__ == "__main__":main()

2. 页眉页脚文字替换：

import win32com.clientdef main():word = win32com.client.Dispatch("Word.Application")word.Visible = True# 打开一个现有的文档doc = word.Documents.Open(r"C:\path\to\your\file.docx")# 访问页眉header_range = doc.Sections(1).Headers(win32com.client.constants.wdHeaderFooterPrimary).Rangeheader_find = header_range.Findheader_find.Text = "old header text"header_find.Replacement.Text = "new header text"header_find.Execute(Replace=2)# 访问页脚footer_range = doc.Sections(1).Footers(win32com.client.constants.wdHeaderFooterPrimary).Rangefooter_find = footer_range.Findfooter_find.Text = "old footer text"footer_find.Replacement.Text = "new footer text"footer_find.Execute(Replace=2)# 保存并关闭文档doc.Save()doc.Close(False)word.Quit()if __name__ == "__main__":main()

3. 打印文档：

import win32com.clientdef main():word = win32com.client.Dispatch("Word.Application")word.Visible = True# 打开一个现有的文档doc = word.Documents.Open(r"C:\path\to\your\file.docx")# 打印文档doc.PrintOut()# 关闭文档doc.Close(False)word.Quit()if __name__ == "__main__":main()