官方文档：
- Microsoft >> office 开发人员中心 Excel
- GitHub >> MicrosoftDocs/VBA-Docs
目 录
- 一、前沿
- 二、库导入及类的初始化
- 三、工作簿及工作表（Workbook & Worksheet）
- 1、新建工作簿
- 2、打开工作簿
- 3、新建工作表
- 4、删除工作表
- 四、单元格及区域（Cell & Range）
- 1、读取单元格的值
- 2、设置单元格的值
- 3、设置单元格格式
- 4、区域（某一范围内的全部单元格）
- 五、文件
- 1、保存及关闭
- 2、另存为
- 3、退出
- 六、枚举(Excel)
- 1、常量枚举
- 2、XlFileFormat 枚举 (文件格式)
- 七、测试代码
- 八、参考文献
- 九、尾声
一、前沿
利用本文代码可以实现读写.xlsx、.xls及.csv文件，单元格格式的简单设置，文件的另存为等。
1、pywin32库的安装
如已安装Anaconda，在 Anaconda Prompt 中键入 pip install pywin32 便可自动完成该库的导入；如未安装 Anaconda，也可 pip 手动导入，其在PyPI（Python Package Index）上的注册地址为： https://pypi.org/project/pywin32 。
2、版本说明
pywin32: 224
Excel: 2016
3、COM
COM（Component Object Model，组件对象模型）是微软公司于1993年提出的一种组件技术，它是一种平台无关、语言中立、位置透明、支持网络的中间件技术。
组件对象模型，一种面向对象的编程模式。它定义了对象在单个应用程序内部或多个应用程序之间的行为方式。它是微软对于网页服务器与客户端、增益集与Office系列软件之间交互的一项软件组件技术。
二、库导入及类的初始化
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
=============================
Author = Hulunbuir & DalaiNur
Email: liyang@alu.hit.edu.cn
Last Update: 2019.09.09 18:47
=============================
"""
import
win32com
.
client
import
os
class
Excel
:
def
__init__
(
self
,
file_abs_path
=
None
,
create_if_not_exists
=
False
,
visible
=
False
,
display_alerts
=
False
)
:
"""初始化数据
:param file_abs_path: 文件的绝对路径
:param create_if_not_exists: 文件不存在则不新建（默认）
:param visible: Excel程序不可见（默认）
:param display_alerts: 不显示警告信息（默认）
"""
self
.
_visible
=
visible
self
.
_display_alerts
=
display_alerts
self
.
_xlApp
=
win32com
.
client
.
Dispatch
(
"Excel.Application"
)
self
.
_xlApp
.
DisplayAlerts
=
self
.
_display_alerts
# 关闭警告（默认）
self
.
_xlApp
.
Visible
=
self
.
_visible
# Excel对象不可见（默认）
self
.
file_abs_path
=
file_abs_path
# 文件的绝对路径
self
.
_create_if_not_exists
=
create_if_not_exists
# 文件不存在是否新建选项
self
.
_xlBook
=
None
try
:
# 打开文件
self
.
_xlBook
=
self
.
_xlApp
.
Workbooks
.
Open
(
self
.
file_abs_path
)
print
(
f
"""文件【{self.file_abs_path}】已打开！"""
)
except
:
# 文件打开失败后判断是否新建文件
if
not
create_if_not_exists
:
# 文件打开失败后不新建文件
print
(
f
"""文件【{self.file_abs_path}】打开失败！"""
)
raise
Exception
(
f
"""文件【{self.file_abs_path}】不存在，请检查输入路径！"""
)
else
:
# 文件打开失败后新建文件
print
(
"文件新建中..."
)
dirct
=
os
.
path
.
split
(
self
.
file_abs_path
)
[
0
]
# 获取文件路径
dir_exist
=
os
.
path
.
isdir
(
dirct
)
# 判断路径是否存在
file_name
=
os
.
path
.
split
(
self
.
file_abs_path
)
[
1
]
# 获取文件名
# 判断所给文件路劲及文件名的合理性
if
dir_exist
:
try
:
# 根据文件拓展名新建各种格式的文件
ext
=
os
.
path
.
splitext
(
self
.
file_abs_path
)
[
1
]
# 获取文件拓展名
xl_file_format
=
{
".xlsx"
:
51
,
".xls"
:
56
,
".csv"
:
6
}
# 代表相应文件格式的数值
# .xls 97-2003文件；.csv 逗号分隔值文件。
file_format_value
=
xl_file_format
[
ext
]
if
ext
in
xl_file_format
else
51
# 根据拓展名确定文件格式标识码，默认格式为.xlsx，其标识码为51。
wb
=
self
.
_xlApp
.
Workbooks
.
Add
(
)
# 新建工作簿
wb
.
SaveAs
(
self
.
file_abs_path
,
file_format_value
)
# 文件另存为
print
(
f
"""文件【{self.file_abs_path}】已创建！！"""
)
self
.
_xlBook
=
self
.
_xlApp
.
Workbooks
.
Open
(
self
.
file_abs_path
)
print
(
f
"""新建文件【{self.file_abs_path}】已打开！！"""
)
except
:
# 文件名称不合法
raise
Exception
(
f
"""文件名称【{file_name}】不合法！"""
)
else
:
# 文件路径不合法
raise
Exception
(
f
"""文件目录【{dirct}】不存在！"""
)
三、工作簿及工作表（Workbook & Worksheet）
1、新建工作簿
2、打开工作簿
3、新建工作表
def
add_sheet
(
self
,
new_sheet_name
=
None
,
new_sheet_location
=
None
)
:
"""为工作簿添加工作表，默认向右添加。
:param new_sheet_name: 新添加工作表的名称
:param new_sheet_location: 新添加工作表的位置
"""
try
:
if
new_sheet_location
is
None
:
# 新建工作表位于到最右侧
new_sheet_location
=
self
.
_xlBook
.
Worksheets
(
self
.
_xlBook
.
Worksheets
.
Count
)
sht
=
self
.
_xlBook
.
Worksheets
.
Add
(
Before
=
None
,
After
=
new_sheet_location
)
if
new_sheet_name
is
not
None
:
sht
.
Name
=
new_sheet_name
elif
new_sheet_location
==
0
:
# 新建工作表位于到最左侧
new_sheet_location
=
self
.
_xlBook
.
Worksheets
(
1
)
sht
=
self
.
_xlBook
.
Worksheets
.
Add
(
Before
=
new_sheet_location
)
if
new_sheet_name
is
not
None
:
sht
.
Name
=
new_sheet_name
else
:
# 新建工作表位于指定工作表之后
new_sheet_location
=
self
.
_xlBook
.
Worksheets
(
new_sheet_location
)
sht
=
self
.
_xlBook
.
Worksheets
.
Add
(
Before
=
None
,
After
=
new_sheet_location
)
if
new_sheet_name
is
not
None
:
sht
.
Name
=
new_sheet_name
except
:
print
(
"工作表名称已存在"
)
raise
Exception
(
f
"""工作表名称【{new_sheet_name}】已存在！"""
)
4、删除工作表
def
delete_sheet
(
self
)
:
# 删除工作表
pass
四、单元格及区域（Cell & Range）
1、读取单元格的值
def
get_cell_value
(
self
,
sheet
,
row
,
col
)
:
"""读取单个单元格的值
:param sheet: 工作表名称或索引号
:param row: 单元格的行号
:param col: 单元格的列号
"""
sht
=
self
.
_xlBook
.
Worksheets
(
sheet
)
return
sht
.
Cells
(
row
,
col
)
.
Value
2、设置单元格的值
def
set_cell_value
(
self
,
sheet
,
row
,
col
,
value
)
:
"""设置单个单元格的值
:param sheet: 工作表名称或索引号
:param row: 单元格行的索引号
:param col: 单元格列的索引号(column)
:param value: 设置的数值
"""
sht
=
self
.
_xlBook
.
Worksheets
(
sheet
)
sht
.
Cells
(
row
,
col
)
.
Value
=
value
3、设置单元格格式
def
set_cell_format
(
self
,
sheet
,
row
,
col
,
bold
=
False
,
font_clr
=
None
,
background
=
None
,
center
=
False
)
:
"""设置单个单元格格式
:param sheet: 设置格式的工作表名称或索引号
:param row: 设置格式的单元格行索引号
:param col: 设置格式的单元格列索引号(column)
:param bold: 文字加粗（默认不加粗）
:param font_clr: 字体颜色
:param background: 单元格背景色
:param center: 设置水平居中(默认不水平居中)
注：颜色代号——https://blog.csdn.net/weixin_34202952/article/details/85416015
"""
sht
=
self
.
_xlBook
.
Worksheets
(
sheet
)
if
bold
:
sht
.
Cells
(
row
,
col
)
.
Font
.
Bold
=
bold
# 设置文字加粗
if
font_clr
is
not
None
:
sht
.
Cells
(
row
,
col
)
.
Font
.
ColorIndex
=
font_clr
# 设置文字颜色
if
background
is
not
None
:
sht
.
Cells
(
row
,
col
)
.
Interior
.
ColorIndex
=
background
# 单元格背景色
if
center
:
sht
.
Cells
(
row
,
col
)
.
HorizontalAlignment
=
-
4108
# 设置平居中xlCenter
4、区域（某一范围内的全部单元格）
def
get_range
(
self
)
:
# 获取指定区域内的全部单元格数值
pass
五、文件
1、保存及关闭
def
save
(
self
)
:
# 保存工作簿
print
(
f
"""文件【{self.file_abs_path}】已保存！"""
)
return
self
.
_xlBook
.
Save
(
)
def
close
(
self
)
:
# 关闭工作簿
print
(
f
"""文件【{self.file_abs_path}】已关闭！"""
)
return
self
.
_xlBook
.
Close
(
)
2、另存为
def
save_as
(
self
,
new_file_abs_path
=
None
)
:
"""文件另存为
:param new_file_abs_path: 另存为文件的绝对路径
"""
new_dirct
=
os
.
path
.
split
(
new_file_abs_path
)
[
0
]
# 另存为文件的文件夹路径与原文件保持一致
new_dirct_exist
=
os
.
path
.
isdir
(
new_dirct
)
# 判断另存为文件的路径是否存在
new_file_name
=
os
.
path
.
split
(
new_file_abs_path
)
[
1
]
# 另存为文件的名称
ori_file_name
=
os
.
path
.
split
(
self
.
file_abs_path
)
[
1
]
# 原文件的名称
ori_ext
=
os
.
path
.
splitext
(
self
.
file_abs_path
)
[
1
]
# 获取原文件的拓展名
new_ext
=
os
.
path
.
splitext
(
new_file_name
)
[
1
]
# 获取另存为文件的拓展名
if
new_dirct_exist
:
if
new_file_name
==
ori_file_name
:
print
(
"另存为文件名称（含拓展名）与原文件完全一致"
)
raise
Exception
(
f
"""另存为文件名称【{new_file_name}】与原文件名称【{ori_file_name}】完全一致！"""
)
else
:
if
ori_ext
==
new_ext
:
print
(
"另存为文件与原文件拓展名一致，文件格式保持不变。"
)
self
.
_xlBook
.
SaveAs
(
new_file_abs_path
)
else
:
xl_file_format
=
{
".xlsx"
:
51
,
".xls"
:
56
,
".csv"
:
6
}
file_format_value
=
xl_file_format
[
new_ext
]
self
.
_xlBook
.
SaveAs
(
new_file_abs_path
,
file_format_value
)
print
(
f
"""文件【{ori_file_name}】已另存为【{new_file_name}】！"""
)
print
(
f
"""文件格式由【{ori_ext}】变为【{new_ext}】！"""
)
print
(
f
"""另存为文件的绝对路径为【{new_file_abs_path}】。"""
)
else
:
raise
Exception
(
f
"""另存为文件的文件目录【{new_dirct}】不存在！"""
)
3、退出
def
quit
(
self
)
:
# 退出程序
print
(
f
"""程序已退出！"""
)
return
self
.
_xlApp
.
Quit
(
)
六、枚举(Excel)
1、常量枚举
| 名称 | 值 | 说明 |
|---|---|---|
| xlCenter | -4108 | 居中 |
更多详见：https://docs.microsoft.com/zh-cn/office/vba/api/excel.constants 。
2、XlFileFormat 枚举 (文件格式)
| 名称 | 值 | 说明 | 拓展名 |
|---|---|---|---|
| xlCSV | 6 | CSV | *.csv |
| xlExcel8 | 56 | Excel 97-2003工作簿 | *.xls |
| xlWorkbookDefault | 51 | 默认工作簿 | *.xlsx |
更多格式详见：https://docs.microsoft.com/zh-cn/office/vba/api/excel.xlfileformat 。
七、测试代码
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
=============================
Author = Hulunbuir & DalaiNur
Email: liyang@alu.hit.edu.cn
Last Update: 2019.09.09 18:47
=============================
"""
if
__name__
==
"__main__"
:
# 测试代码
xl
=
Excel
(
r
"D:\Test.xlsx"
,
create_if_not_exists
=
1
)
# 打开文件，若文件不存在则新建并打开。
xl
.
set_cell_value
(
"Sheet1"
,
row
=
1
,
col
=
1
,
value
=
"H100"
)
# 设置单元格单元格数值
xl
.
set_cell_value
(
1
,
row
=
2
,
col
=
"B"
,
value
=
"H200"
)
# 设置单元格单元格数值
print
(
xl
.
get_cell_value
(
"Sheet1"
,
row
=
1
,
col
=
1
)
)
# 读取单元格数值
xl
.
add_sheet
(
"New_Sheet1"
,
0
)
# 目前New_Sheet1位于最左侧
xl
.
add_sheet
(
"New_Sheet2"
)
# 目前New_Sheet2位于最后
xl
.
add_sheet
(
"New_Sheet3"
,
2
)
# 目前New_Sheet3位于第二个工作表之后
xl
.
add_sheet
(
)
# 目前位于最后，名称采用系统默认名称
xl
.
add_sheet
(
new_sheet_location
=
3
)
# 目前位于第3个工作边之后，名称采用系统默认名称
xl
.
set_cell_value
(
4
,
row
=
1
,
col
=
1
,
value
=
"H300"
)
# 设置单元格单元格数值
xl
.
set_cell_value
(
5
,
row
=
1
,
col
=
1
,
value
=
"H400"
)
# 设置单元格单元格数值
xl
.
set_cell_format
(
"Sheet1"
,
row
=
1
,
col
=
1
,
font_clr
=
3
,
bold
=
True
,
background
=
15
,
center
=
True
)
# 设置单元格格式（红色加粗灰色背景水平居中）
xl
.
set_cell_format
(
"Sheet1"
,
row
=
2
,
col
=
2
,
font_clr
=
5
)
# 蓝色字体
xl
.
save
(
)
# 保存文件
xl
.
save_as
(
r
"D:\Test.xls"
)
# 文件另存为.xls文件
xl
.
close
(
)
# 关闭文件
xl
.
quit
(
)
# 退出程序
八、参考文献
[1] Mark Hammond, Andy Robinson. Python Programming on Win32 Chapter 9 - Integration with Excel.
[2] 热心市民小磊. win32com模块 https://blog.csdn.net/u013289615/article/details/89295957.
[3] zhu2695. C# Excel ColorIndex 对应列表 https://blog.csdn.net/zhu2695/article/details/47444745.
九、尾声
以上，便是利用pywin32库对Excel进行二次开发的简单介绍，因篇幅有限，某些非关键功能未做详细介绍，如有疑问，欢迎邮件来询。
仅以此文为我的Python调用Excel有关功能的实现做个一个备忘，同时也为有需要的人提供多一点参考。
胸藏文墨怀若谷，腹有诗书气自华，希望各位都能在知识的pāo子里快乐徜徉。
因个人水平有限，文中难免有所疏漏，还请各位大神不吝批评指正。
最后，祝各位攻城狮们，珍爱生命，保护发际线！
本文部分内容来自图书 Python Programming on Win32 ！
欢迎大家点赞、评论及转载，转载请注明出处！
为我打call，不如为我打款！
打赏可备注邮箱，本人会将上述代码发送给各位土豪！
