ReportLab中ListStyle无法设置编号列表数字样式的解决方法咨询

我正在使用ReportLab的ListStyle创建编号列表，但设置列表中编号的样式无法生效，例如将字号改为fontSize=6没有任何效果，代码如下：

from reportlab.lib.styles import ParagraphStyle, ListStyle
from reportlab.platypus import SimpleDocTemplate, Paragraph
from reportlab.platypus import ListFlowable, ListItem

filename = g.PATH_TO_SAVE_RL_SAMPLES + "testing_9.pdf"
doc = SimpleDocTemplate(filename, pagesize=pagesizes.portrait(pagesizes.A4), 
        leftMargin = 2.2 * cm, 
        rightMargin = 2.2 * cm,
        topMargin = 1.5 * cm, 
        bottomMargin = 2.5 * cm)

story = []

number_style = ListStyle('number_style', fontName="Helvetica-Bold", fontSize=6)
text_style = ParagraphStyle('number_style', fontName="Helvetica", fontSize=6)

my_list = [
ListItem(Paragraph('List item number one.', text_style), value=1, style=number_style),
ListItem(Paragraph('List item number two.', text_style), value=2, style=number_style),
ListItem(Paragraph('List item number four.', text_style), value=4, style=number_style),
ListItem(Paragraph('List item number eight.', text_style), value=8, style=number_style),
]

story.append(ListFlowable(my_list))

doc.build(story)

输出效果：PDF中的编号字号未按设置变为6号，依然保持默认大小，编号的粗体设置也未生效。

请问是否有方法设置ListItem中编号的样式？

解决方法 #

ReportLab的ListStyle本身不支持直接设置编号的字体样式，需要通过自定义编号格式化函数或手动构造列表项的方式实现。

方法一：自定义编号格式化函数 #

通过ListStyle的format参数传入自定义函数，返回带样式的编号段落来控制样式：

from reportlab.lib.styles import ParagraphStyle, ListStyle
from reportlab.platypus import SimpleDocTemplate, Paragraph
from reportlab.platypus import ListFlowable, ListItem
from reportlab.lib.pagesizes import A4, portrait
from reportlab.lib.units import cm

# 定义编号的专属段落样式
number_paragraph_style = ParagraphStyle(
    'number_style',
    fontName="Helvetica-Bold",
    fontSize=6,
    leading=8  # 匹配字号设置行高，避免排版错乱
)

# 自定义编号格式化函数，返回带样式的Paragraph对象
def custom_number_formatter(value):
    return Paragraph(str(value), number_paragraph_style)

filename = g.PATH_TO_SAVE_RL_SAMPLES + "testing_9.pdf"
doc = SimpleDocTemplate(
    filename,
    pagesize=portrait(A4),
    leftMargin=2.2 * cm,
    rightMargin=2.2 * cm,
    topMargin=1.5 * cm,
    bottomMargin=2.5 * cm
)

story = []

# 配置ListStyle，指定format为自定义函数
number_style = ListStyle(
    'number_style',
    format=custom_number_formatter,
    leftIndent=12,  # 调整编号与文本的间距
    bulletIndent=0
)

text_style = ParagraphStyle(
    'text_style',
    fontName="Helvetica",
    fontSize=6,
    leading=8
)

my_list = [
    ListItem(Paragraph('List item number one.', text_style), value=1, style=number_style),
    ListItem(Paragraph('List item number two.', text_style), value=2, style=number_style),
    ListItem(Paragraph('List item number four.', text_style), value=4, style=number_style),
    ListItem(Paragraph('List item number eight.', text_style), value=8, style=number_style),
]

story.append(ListFlowable(my_list))

doc.build(story)

方法二：手动构造带编号的列表项 #

直接在列表项内容中拼接带样式的编号与文本，或拆分编号和文本分别设置样式：

from reportlab.lib.styles import ParagraphStyle
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer
from reportlab.platypus import ListFlowable, ListItem
from reportlab.lib.pagesizes import A4, portrait
from reportlab.lib.units import cm, mm

filename = g.PATH_TO_SAVE_RL_SAMPLES + "testing_9.pdf"
doc = SimpleDocTemplate(
    filename,
    pagesize=portrait(A4),
    leftMargin=2.2 * cm,
    rightMargin=2.2 * cm,
    topMargin=1.5 * cm,
    bottomMargin=2.5 * cm
)

story = []

number_style = ParagraphStyle(
    'number_style',
    fontName="Helvetica-Bold",
    fontSize=6,
    leading=8
)

text_style = ParagraphStyle(
    'text_style',
    fontName="Helvetica",
    fontSize=6,
    leading=8,
    leftIndent=15  # 给编号预留空间
)

# 两种构造方式：直接拼接编号与文本 / 拆分编号和文本用Spacer控制间距
my_list = [
    # 方式1：直接拼接
    ListItem(Paragraph(f"1. {'List item number one.'}", text_style)),
    # 方式2：拆分编号和文本，更灵活控制样式
    ListItem(
        [
            Paragraph("2.", number_style),
            Spacer(1, 2*mm),
            Paragraph("List item number two.", text_style)
        ],
        leftIndent=20
    ),
    ListItem(Paragraph(f"4. {'List item number four.'}", text_style)),
    ListItem(Paragraph(f"8. {'List item number eight.'}", text_style)),
]

story.append(ListFlowable(my_list))

doc.build(story)

关键说明 #

• 原代码中给ListStyle传入fontName、fontSize参数是无效的，ReportLab官方文档并未将这些列为ListStyle的合法配置项，属于误用。
• 自定义format函数是控制编号样式的标准方案，支持返回任意Flowable对象，能实现更复杂的编号样式（比如带颜色、特殊符号等）。

内容的提问来源于stack exchange，提问作者YesThisIsMe