要让GammaAI自动识别并生成图表，CSV文件本身的“基础”必须提前打好。首行必须使用规范的列名，不能含有特殊符号；编码格式需为UTF-8（不带BOM）；数值列中只能包含数字，不能混入文本——否则系统无法自动生成图表。上传后如果发现列名显示为“Column 1”，不必慌张，手动启用首行标题开关即可。之后，便可通过推荐图表、字段绑定，或直接使用自然语言指令来生成可视化内容。

简单来说，GammaAI为已有CSV文件自动识别列名并生成可视化图表，前提是文件结构清晰、编码规范，且字段语义能被系统正确判读。如果上传后只看到原始表格而图表迟迟未出现，大概率是遇到了以下问题：列名缺失、首行被误读为数据，或数值列中混入了非数字字符，导致系统类型推断失败。

检查CSV文件是否具备自动识别条件

GammaAI依赖首行作为列名，并根据内容自动判断字段类型（如日期、数值、分类）。如果这一步没做好，后续所有图表生成都将无效。

使用文本编辑器（如Notepad++或VS Code）打开CSV文件，确认第一行确实是列名，且不能包含空格、中文括号、斜杠等特殊符号。举例来说：“销售日期,产品名称,销量,销售额”是合规的；但“销售日期 / 产品名称 / 销量 / 销售额”会导致列名被截断为单独字段，系统无法识别。

还需检查第二行开始是否存在整行空值？或者某列在前10行里混入了文字与数字（如“-”、“N/A”、“暂缺”）？这类混合类型会使GammaAI将整列识别为文本型，后续想要生成柱状图、折线图等数值类图表，就无法实现了。

保存文件时，务必选择【UTF-8 编码】，切勿使用“UTF-8 with BOM”。否则GammaAI可能会将BOM字节当作首字符，导致第一列名的开头出现不可见乱码，列名识别直接失败——这是最隐蔽也最容易踩中的坑。

上传CSV并触发自动可视化流程

进入GammaAI编辑界面，直接将CSV文件拖入正文区域，或点击“+”号选择“Upload file”上传。

文件上传成功后，GammaAI会在右侧弹出“Data Preview”面板，自动解析并展示前5行数据。此时如果看到列名显示为“Column 1”“Column 2”，说明首行未被识别为标题。别急，手动点击面板右上角的【Use first row as headers】开关，一步即可解决。

面板底部还会出现“Suggested visualizations”区块，列出3到5种图表建议——例如“销量随时间变化趋势图”“各产品销量占比饼图”。这些推荐是基于列名关键词（如包含“date”“time”会触发时间序列图，包含“category”“type”会触发分组统计）和数值列分布自动推断得出的，基本无需额外指令。

手动指定图表类型与字段映射

方法一：点击任一推荐图表下方的“Edit”按钮，进入字段绑定页。左侧勾选X轴字段（如“销售日期”）、Y轴字段（如“销量”）、分组字段（如“产品名称”），右上角点“Apply”即可。

方法二：不依赖推荐，直接在Data Preview面板中点击某列标题，下拉菜单选择“Visualize as”，然后从中选取“Bar chart”“Line chart”“Pie chart”等。GammaAI会立即在当前幻灯片插入对应图表，并自动完成字段绑定——这是最直接的操作方式。

方法三：在编辑区任意位置输入自然语言指令，例如：“用柱状图展示各城市销售额，按金额降序排列”。GammaAI会解析指令中的实体（城市、销售额）、动作（柱状图、降序）和约束（排序），自动匹配对应列并渲染图表。但前提是列名中必须明确包含“城市”“销售额”这类关键词。如果列名是“city”“revenue”，则需要先在Data Preview中重命名为中文，否则指令无法命中。

注意：重命名列名后，原CSV文件不会被修改，仅影响当前会话中的可视化逻辑——放心操作，不会污染原始数据。