使用XlsxWriter 1.2.1无法创建自定义数据标签求助

版本问题确认 #

你遇到的问题确实和XlsxWriter 1.2.1的版本限制有关：该版本对柱状图自定义数据标签的支持存在缺陷，自定义标签逻辑未正确生效，导致始终显示默认数值标签。后续版本（1.3.0及以上）修复了该问题，但由于你无法升级库，可通过手动注入XML代码的方式绕过版本限制实现需求。

适配1.2.1版本的解决方案 #

XlsxWriter生成的Excel图表基于OOXML格式，我们可以直接修改图表的XML结构，强制添加自定义数据标签。以下是具体实现代码：

import xlsxwriter

# 创建工作簿和工作表
workbook = xlsxwriter.Workbook('custom_labels.xlsx')
worksheet = workbook.add_worksheet()

# 写入示例数据（包含自定义标签列）
data = [
    ['类别', '数值', '自定义标签'],
    ['A', 10, '达标'],
    ['B', 20, '优秀'],
    ['C', 15, '达标'],
    ['D', 25, '优秀'],
]

for row_num, row_data in enumerate(data):
    worksheet.write_row(row_num, 0, row_data)

# 创建常规柱状图
chart = workbook.add_chart({'type': 'column'})

# 添加数据系列（先按常规流程配置，后续修改XML）
chart.add_series({
    'name': '=Sheet1!$B$1',
    'categories': '=Sheet1!$A$2:$A$5',
    'values': '=Sheet1!$B$2:$B$5',
})

# 获取图表原始XML内容
chart_xml = chart._get_xml_data()

# 替换XML片段，添加自定义数据标签配置
# 禁用默认数值显示，将标签指向自定义文本所在的C列
updated_xml = chart_xml.replace(
    '<c:ser>',
    '''<c:ser>
          <c:dLbls>
            <c:showVal val="0"/>
            <c:showCatName val="0"/>
            <c:showSerName val="0"/>
            <c:showLegendKey val="0"/>
            <c:tx>
              <c:strRef>
                <c:f>Sheet1!$C$2:$C$5</c:f>
                <c:strCache>
                  <c:ptCount val="4"/>
                  <c:pt idx="0"><c:v>达标</c:v></c:pt>
                  <c:pt idx="1"><c:v>优秀</c:v></c:pt>
                  <c:pt idx="2"><c:v>达标</c:v></c:pt>
                  <c:pt idx="3"><c:v>优秀</c:v></c:pt>
                </c:strCache>
              </c:strRef>
            </c:tx>
          </c:dLbls>'''
)

# 更新图表的XML数据
chart.set_xml_data(updated_xml)

# 将图表插入工作表
worksheet.insert_chart('E2', chart)

workbook.close()

关键说明 #

1. 核心逻辑：通过修改XML结构，禁用默认数值标签（<c:showVal val="0"/>），并将数据标签的文本来源指向存储自定义内容的单元格范围。
2. 适配调整：需确保XML中的单元格引用、标签数量（<c:ptCount val="4"/>）与实际数据行数完全匹配；如果自定义标签是固定文本，可直接修改<c:v>中的内容。
3. 效果验证：生成的Excel文件中，柱状图会显示你设置的自定义标签，而非默认数值。

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