使用XlsxWriter模块在Python中实现Excel单元格内多种格式文本的高效写入

XlsxWriter 简介： XlsxWriter 是 python 用来构造 xlsx 后缀 excel 文件的模块，其具备强大的写入功能， 可以说是在 excel 视图中你可以进行的操作都有其对应的实现方法，如富文本写入，控制文本格式，设置列宽等， 然后很重要的一点就是，它不仅仅只是生成数据，还能插入直方图，饼图….(点击此处查看如何插入图)，使用条件格式，合并单元格等等这些操作。 附 XlsxWriter 官方文档

需要注意的一点是 XlsxWriter 模块只能写入而不能读取和修改！

接下来通过以下示例主要展示常见的使用方法：

1. 首先通过 xlsxwriter.Workbook("xlsx_path") 创建一个 workbook 对象，之后可以通过workbook.add_format() 方法先定义需要的样式如下

red = workbook.add_format({"color": "red"}) # 这样我们就有了一个红色样式

其中方法参数是一个字典， 在字典中我们可以给定多个样式如下，RGB颜色参考表（可点击此处查看），其效果可见效果图中 B2 单元格

style = workbook.add_format({
'border': 1, # 边框
'align': 'center', # 水平居中
'valign': 'vcenter', # 垂直居中
'bold': True, # 加粗（默认False）
'font': u'宋体', # 字体
'fg_color': '#FFFF00', # 背景色
'color': 'green' # 字体颜色
})


设置列宽， 函数为 set_column(self, first_col, last_col, :" 分割调用时给定的第一个参数字符串之后解压成这两个参数来指定开始和结束列号（注：前列不能大于后列），调用时第二个参数即 width，可以设定需要将这些列的宽度设为多少， 其效果可见效果图中 B 列

worksheet.set_column("B:B", 30)

设置自动换行格式（可将代码合成一行）， 其效果可见效果图中 A 列

column_text_wrap = workbook.add_format()
column_text_wrap.set_text_wrap()

1. 写入文本及格式

一般的写入方法如下， 其效果可见效果图 A1 单元格

worksheet.write("A1", "段落", bold)

多格式文本写入，将多个定义好的样式整体应用， 其效果可见效果图 B2 单元格

worksheet.write("B2", "陈平安", style)

同一单元格内应用不同格式， 调用时其第一个参数定位其单元格，之后从第二个参数开始两两为一对分别对应 {样式， 文本}，即可自定义不同部分的不同样式，其效果可见效果图 A2 单元格

# def write_rich_string(self, row, col, *args):
# """
# Write a "rich" string with multiple formats to a worksheet cell.
#
# Args:
# row: The cell row (zero indexed).
# col: The cell column (zero indexed).
# string_parts: String and format pairs.
# cell_format: Optional Format object.
#
# Returns:
# 0: Success.
# -1: Row or column is out of worksheet bounds.
# -2: String truncated to 32k characters.
# -3: 2 consecutive formats used.
# -4: Empty string used.
# -5: Insufficient parameters.
#
# """
worksheet.write_rich_string("A%d" % 2,
"陈平安是从右到左，住在小茅屋的曹慈则是从左到右。两人视线交汇，双方都无停步的意思，继续各自前行，最终遥遥地擦肩而过。当下，",
red, "陈平安",
"一身拳意极为细微，绝大部分都已经被剑气死死压制。而曹慈一身刚猛拳罡，汹涌外泄，肉眼可见，好像反过来压制了四周的城头剑气。在陈平安一路缓缓走桩，最终临近老剑仙所住茅屋的时候，曹慈已经来回打完一趟拳，赶上了陈平安。")


设置单元格下拉选择框， 调用时第一个参数为单元格位置， 第二个参数为一个字典， 第一个键 validate 需要设为 list， 之后 source 键即为下拉框中的值， 其通过引用表中数据实现（一个单元格一个值）， 引用单元格写法为 "$开始列号(字母)$开始行号(数字):$结束列号$结束行号" ， 其效果如效果图中 C2 单元格

worksheet.data_validation('C%d' % 2, {'validate': 'list', 'source': "=$F$1:$%s$1" % get_column_letter(len(levels) + 3)}) # get_column_letter 是 openpyxl.utils 工具包中提供的一个提供由数字转为 excel 中列号字母的方法

效果图如下：

完整代码：

def xlsx_writer_sample(output_path):
workbook = xlsxwriter.Workbook(output_path)
# 设置某个格式
red = workbook.add_format({ "color": "red"})
bold = workbook.add_format({ "bold": True})
# 设置自动换行
column_text_wrap = workbook.add_format()
column_text_wrap.set_text_wrap()
# 自定义格式
style = workbook.add_format({
'border': 1, # 边框
'align': 'center', # 水平居中
'valign': 'vcenter', # 垂直居中
'bold': True, # 加粗（默认False）
'font': u'宋体', # 字体
'fg_color': '#FFFF00', # 背景色
'color': 'green' # 字体颜色
})

# 添加 sheet 并命名
worksheet = workbook.add_worksheet("剑来")

# 设置 A 列宽度及自动换行
worksheet.set_column("A:A", 60, column_text_wrap)
# 设置 B 列宽度
worksheet.set_column("B:B", 30)
# 写入 A1, B1 内容并给定加粗样式
worksheet.write("A1", "段落", bold)
worksheet.write("B1", "主角", bold)
# 从 D1 位置写入多格
levels = ["泥胚境", "木胎境", "水银镜", "炼神三境", "金身境", "远游境", "山巅境", "止境", "武神"]
worksheet.write_row("D1", levels)
# 富文本写入， 对文本某个部分设置格式
worksheet.write_rich_string("A%d" % 2,
"陈平安是从右到左，住在小茅屋的曹慈则是从左到右。两人视线交汇，双方都无停步的意思，继续各自前行，最终遥遥地擦肩而过。当下，",
red, "陈平安",
"一身拳意极为细微，绝大部分都已经被剑气死死压制。而曹慈一身刚猛拳罡，汹涌外泄，肉眼可见，好像反过来压制了四周的城头剑气。在陈平安一路缓缓走桩，最终临近老剑仙所住茅屋的时候，曹慈已经来回打完一趟拳，赶上了陈平安。")
# 为某个单元格写入内容并给定格式， 此格式包含 边框、居中、字体及背景色等
worksheet.write("B2", "陈平安", style)

# 引用下拉选择框
worksheet.data_validation('C%d' % 2, { 'validate': 'list', 'source': "=$F$1:$%s$1" % get_column_letter(len(levels) + 3)})
# 调用 close 方法 结束不报错即成功写入文件
workbook.close()


参考：

1. Python中XlsxWriter模块简介与用法分析 https://www.jb51.net/article/138813.htm
2. python模块之XlsxWriter https://www.cnblogs.com/fkissx/p/5617630.html
3. xlsxwriter基本用法 https://www.jianshu.com/p/e4b8dd083489