在人工智能内容学习中，新手必看：CodeBuddy数据质量检查指南是常见主题。很多人在阅读时会遇到概念分散、步骤不清和注意点难以归纳的问题。本文按照基础概念、操作流程和关键细节，对相关内容进行整理。

新手需按三步预检：1. Excel定位空值并补全必填字段；2. 数值列设数值格式并清除文本混入；3. 中文字段分列重置文本格式；上传后须启用自动质量扫描，配置预置或自定义规则并发布；红色告警需据示例值修正元数据或原始数据。

刚接触CodeBuddy的新手常因数据格式不规范、字段缺失或类型错配，导致质量检查反复失败甚至阻塞后续建模流程。本指南直接给出可立即执行的检查路径与修复动作，覆盖从本地文件上传前校验到平台内实时反馈的完整链路。

上传前用Excel快速筛查基础问题

适用于CSV/Excel源文件尚未提交至CodeBuddy平台时的预检。

第一步：打开原始文件，在Excel中按【Ctrl+G】→【定位条件】→勾选【空值】→【确定】，查看高亮单元格是否集中在业务允许的字段（如“备注”列），若在“用户ID”“订单金额”等主键或必填字段出现空值，【必须补全或标记为NULL并确认业务含义】。

第二步：选中数值型列（如“销量”“单价”），右键→【设置单元格格式】→切换至【数值】类别，小数位数设为0～2位；若显示“#####”，说明存在文本混入（如“120元”“缺货”），需用【查找替换】清除非数字字符。

第三步：对含中文的字段（如“商品名称”“地址”）启用【数据】→【分列】→【分隔符号】→取消所有勾选→【完成】，强制触发文本格式重置，避免因隐藏不可见字符（如零宽空格）导致平台解析异常。

在CodeBuddy中启用自动质量规则扫描

文件已上传但未启动分析任务时，必须完成此项配置，否则系统默认跳过质量检查。

方法一：进入【数据集】→点击目标数据表右侧【…】→【编辑元数据】→在【质量规则】栏开启【启用自动扫描】开关。

方法二：在【工作流编排】界面，拖入【数据质量检查】组件→双击打开→勾选【启用字段级规则】→下拉选择预置模板（如“金融类-客户信息校验”），该模板会自动绑定手机号正则、身份证号校验、时间格式ISO8601等12项规则。

注意：若手动添加自定义规则（如“订单金额 ≥ 0”），需点击【+新增规则】→【数值范围】→输入最小值0→【保存】，此时规则名右侧会出现黄色感叹号图标，表示待生效，【必须点击右上角【发布】按钮才真正启用】。

解读质量报告中的红色告警项

运行质量检查后，报告页顶部显示“3项严重问题”即代表阻断级错误，必须处理后才能进入下游任务。

点击任一红色【严重】标签，展开详情页，重点关注【问题字段】与【示例值】两列：若【示例值】显示“2024/13/01”，说明日期格式非法；若显示“NULL”却标注为“非空字段”，说明该列在元数据中设置了【NOT NULL】约束但实际含空值。

修复操作路径：返回【数据集】→【编辑元数据】→找到对应字段→将【是否允许为空】改为【是】→【保存】；若业务上绝对不允许为空，则需回到原始文件修正数据，重新上传并触发检查。