---
title: "Claude Code 图表报告生成：可视化数据分析"
description: "先选路线：让它写绘图代码、画字符草图，还是给表格软件的分步操作。再把图型、标题、轴标签、样式和文件名一次说清，最后用固定骨架写出可核对的报告。"
updated: 2026-11-13
canonical: https://docai.cc/learn/charts-and-report-generation/
markdown_mirror: https://docai.cc/learn/charts-and-report-generation.md
---
## 三种做法，先选一种

让模型写绘图代码，图型和样式都能改，适合每周、每月重复出的同一张图，前提是本机装好了运行环境。让它用字符画个草图，几秒钟就能看出走势，适合讨论时快速对齐。让它写表格软件的分步操作，不用装代码环境，照着菜单点就能出图，适合一次性的场合。

选哪种不取决于难度，而取决于这张图给谁看、以后还要不要重做。给管理层的周报配图，多半值得把代码版调好一次、以后反复用；开会时临时比划两句，字符草图就够了。

## 把规格说到可执行

只说「画个柱状图」，结果一定不是你要的样子。至少交代五样：数据、图型、标题与坐标轴、样式细节、输出文件。

> 用 Python 的绘图库画一张柱状图。月份一到六月，销售额依次是 42、49、46、66、72、61 万元。标题写「一到六月销售额」，纵轴标注单位万元，每根柱子顶端显示数值，颜色用深蓝，结果存成图片文件。

数据和样式分两段写，以后改样式不容易碰坏数据。运行前先确认解释器和绘图库已经装好，缺什么它会提示你补。不想装环境，也可以让它把代码改成能在浏览器里跑的版本，或者直接走操作步骤那条路。

## 图表类型与场景对照

| 图型 | 什么时候用 | 例子 |
| --- | --- | --- |
| 柱状图 | 比较几个并列类别的大小 | 各区季度销量 |
| 折线图 | 看一个指标随时间怎么走 | 月度回款趋势 |
| 饼图 | 表达部分占整体的比例 | 费用构成 |
| 散点图 | 看两个变量是否同步变化 | 投放金额与成交额 |
| 堆叠柱状图 | 总量和内部构成一起看 | 各产品月度销量拆分 |

拿不准时，把数据的行列结构和用途讲清楚，让它先推荐图型并说明理由，再做图。理由说得通，图多半也没问题；理由牵强，说明这组数据不适合这张图。

同一张图里不要塞两种目的。既要看总量又要看构成时，堆叠柱状图可以兼顾，但超过五六个分类就会糊成一片，这时拆成两张图更清楚。颜色只用来区分，不用来装饰，图例能省则省。热力图适合看二维分布，比如一周内各小时的用户活跃度，颜色深浅表示数值大小；它读得出模式，读不出精确数字，要下结论就把关键格子的值标出来。

## 表格软件路线：写到菜单级

不想装代码环境，就让它把操作写成能照着点的步骤。提问时把表格结构和软件版本一起交代，步骤才不会对不上：

```text
我有一份月度销售表：A 列是月份（1 月到 12 月），B 列是销售额。
用 Excel 做一张折线图看全年趋势。
请按菜单路径给步骤：选中哪个区域、点哪个选项卡、选哪种图表、
标题和坐标轴在哪里改、怎么把图移到单独的工作表。
我用的是 Excel 2019；如果某一步和你熟悉的版本不同，请标出来。
```

步骤到手后先核对两处：选中的区域是否包含表头，横轴是否被识别成日期而不是文本。前者决定图例，后者决定折线会不会全挤在左边。若软件版本比示例新，菜单名称可能变化，以当前版本为准。

## 报告用骨架固定

一张图说服不了人，报告靠结构。先给骨架，再让它填内容：

> 按下面的结构写一份文字报告：一、关键指标表；二、趋势描述，并注明这里适合配折线图；三、区域对比，用表格呈现；四、三到五条重点发现；五、两到三条下月动作。每节末尾用一句「关键结论」收口。

最后那句约束最容易被忽略：让每节独立收口，读者才能跳读。同时要求数字都注明来自哪一列，算不出来的写「未提供」，不要猜。

报告到手后先核对再美化。增减幅度加箭头、风险项加标记、结论加粗，这些只改呈现，替不了复核。每个数字能追回原始表格，每张图的选型能说出一句理由，报告才算能用。

如果报告要贴进幻灯片，让每节控制在一屏之内：一张图配两三句结论，细节放附录。读者记不住二十个数字，能记住三个判断，报告就成功了。

## 常见故障：现象、原因、处理

| 现象 | 原因 | 处理 |
|---|---|---|
| 图里的中文变成方框 | 绘图环境缺中文字体 | 指定一种已安装的中文字体，或把标签改成英文 |
| 脚本报错说找不到绘图库 | 解释器与安装依赖的环境不是同一个 | 确认当前解释器，再在同一个环境里安装依赖 |
| 柱子上的数值挤成一团 | 类别太多或数字太长 | 改成横向条形图，或只给最高、最低两根标数值 |
| 报告数字和图对不上 | 图和报告各用了一份数据 | 只保留一份源数据，图和表都从它生成 |

图表不是越多越好。超过五个分类的饼图、没有排序的柱状图，读者都要花时间找重点。要交互筛选或定期刷新，交给表格软件或 BI 工具，模型负责把数据和规格整理好；分析本身的方法，可以看[数据统计分析](/learn/data-statistics-analysis/)。

## 自测

1. 这张图是给谁看的、以后会不会重复出？
2. 你给模型的规格里，缺了哪一项？
3. 报告里的每个数字，能追回原始表格的哪一块？

## 下一步

出图和写报告都会反复用到固定结构，下一节把它们沉淀成模板：[工作模板创建](/learn/create-work-templates/)。想让输出格式稳定可解析，可以看[结构化输出](/concepts/structured-output/)。