xlsxwriter 图表数据源必须为工作表中已写入的绝对地址字符串，如'sheet1!$a$2:$a$10'，不可用列表或series；动态行数需手动计算并拼接范围；中文换行和字体渲染受限，需用旋转等变通方式。
XlsxWriter 本身不支持读取或修改已有 Excel 文件，生成图表必须从头写入工作表，且图表数据源必须是 worksheet 中已写入的单元格范围。
为什么 chart.add_series() 总报错 “Invalid range reference”
这是最常卡住的地方：XlsxWriter 要求 add_series() 的 values、categories 参数必须是形如 'Sheet1!$A$2:$A$10' 的字符串，不能用 Python 列表或 pandas Series 直接传入。
- 必须先用
worksheet.write_column()或write_row()把数据写进 sheet，再用绝对地址引用 - sheet 名含空格时，需用单引号包裹，例如
'Data Sheet'!$B$1:$B$5 - 行号列号从 1 开始（Excel 原生逻辑），但 Python 索引从 0 开始，容易算错——建议用
xl_rowcol_to_cell()辅助生成地址 - 不要试图用
worksheet.conditional_format()或其他 API 替代图表数据源，chart 只认单元格区域
如何让柱状图自动适配动态数据行数
硬编码 'Sheet1!$A:$A0' 会留大片空白，影响图表美观和 Excel 文件体积。正确做法是先确定数据长度，再拼接 range 字符串。
data = [12, 45, 23, 67, 34]
worksheet.write_column('A2', data) # 写入 A2:A6
last_row = len(data) + 1 # A2 开始，所以最后一行是 2 + len - 1 = 6
chart.add_series({
'values': f'Sheet1!$A$2:$A${last_row}',
'categories': f'Sheet1!$B$2:$B${last_row}', # 如有分类轴
})
- 避免用
worksheet.dim_rowmax等动态查范围——XlsxWriter 不维护“已用区域”，得靠你自己记 - 如果数据来自 pandas DataFrame，别调
df.to_excel()；用worksheet.write_row()逐行写，才能精确控制起始位置 - 图表对象创建后，必须显式调用
chart.set_size({'x_scale': 1.2})等调整尺寸，否则默认太小
导出后图表显示“此图像包含链接，可能不安全”
这不是代码问题，而是 Excel 客户端行为：XlsxWriter 生成的图表使用内部链接（非 OLE 嵌入），部分 Windows 版本 Excel 会误判为外部引用。
- 确认没在
add_series()中混用本地文件路径（如'C:\data.xlsx'!Sheet1!$A$1）——XlsxWriter 不支持跨文件图表 - 禁用 Excel 的“启用链接”提示：文件 → 选项 → 高级 → 取消勾选“请求将链接更新到此文档”
- 若需彻底规避，可改用
openpyxl（支持读写+图表），但性能明显下降，且图表渲染细节不如 XlsxWriter 稳定
真正麻烦的是坐标轴标签换行和中文宋体渲染——XlsxWriter 对非 ASCII 字体支持有限，chart.set_title({'name': '销售额（万元）'}) 没问题，但 set_x_axis({'name': '产品类别
（2024）'}) 中的换行符会被忽略，得靠 set_x_axis({'num_font': {'rotation': -45}}) 斜排凑合。这点很容易在交付前最后一刻才发现。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
