如何在Python Pandas中实现自动化的数据质量检查报告?

浅强君_9302

浅强君_9302

2026-07-19

888人浏览

原创

pandas.dataframe.describe()可快速识别数值列的nan、标准差为0、异常最大值等问题,但忽略非数值列;建议用describe(include='all')配合isnull().sum()等手动检查缺失率、重复行、列名空格及低唯一性等数据质量硬伤。

如何在python pandas中实现自动化的数据质量检查报告?

用 pandas.DataFrame.describe() 快速暴露数值型字段异常值

它不是万能的,但能立刻告诉你哪些列存在 NaN、标准差为 0、最大值离谱等信号。对非数值列默认跳过,这点容易被忽略——别指望它报出字符串重复率或空格问题。

实操建议:

  • 先调用 df.describe(include='all') 强制包含所有类型,但注意:字符串列只返回 count、unique、top、freq,不计算缺失率
  • 搭配 df.isnull().sum() 单独统计每列缺失数,比 describe 更可靠
  • 若某列 std 为 0 且 min == max,大概率是全相同值或全 NaN,需人工确认是否合理

写一个轻量级 check_data_quality() 函数,覆盖常见硬伤

别依赖第三方库做“全自动”,自己写个 20 行函数更可控。核心是把检查项拆成原子逻辑,每项返回布尔+简短提示,方便后续聚合成报告。

关键检查点:

  • df.empty:空表直接报错,不往下走
  • df.duplicated().sum() > 0:记录重复行数,但注意是否允许业务重复(比如订单明细)
  • df.columns.str.contains(' ').any():列名含空格会导致后续 df.col_name 访问失败
  • 对每列跑 df[col].nunique() / len(df) :低基数列(如 99% 是 “未知”)可能需要标注

用 pd.api.types.is_string_dtype() 和 is_numeric_dtype() 区分字段语义

类型误判是数据质量陷阱的高发区。比如身份证号被读成 int64,后续转字符串会变科学计数法;手机号存成数字后首位 0 消失。

Forge — Python Developer
Forge — Python Developer

Python开发助手 — 自动化脚本、API封装、命令行工具、数据管道、网页爬虫。经过测试的代码,包含错误处理和文档。当你需要...

下载

必须显式校验:

  • 业务上应为字符串的字段(ID、编码、地址),用 is_string_dtype(df[col]) 确认,否则提醒“疑似数值型误读”
  • 日期字段不能只看列名含 “date”,要试 pd.to_datetime(df[col], errors='coerce') 后检查 isna().sum()
  • object 类型不等于字符串——可能是混合类型(str + int + None),用 df[col].apply(type).nunique() 检查

生成可读报告时,避免堆砌表格,优先输出结构化字典

别一上来就 to_html() 或 to_markdown(),调试阶段用 print(json.dumps(report_dict, indent=2)) 更快定位哪项失败。

推荐 report 字典结构:

{
  "shape": [12345, 12],
  "missing": {"user_id": 32, "email": 187},
  "duplicates": 4,
  "dtype_issues": ["order_id should be string but is int64"],
  "low_cardinality": ["status", "source"]
}

这样后续导出 Excel 或发邮件都只需一层封装,也方便加告警阈值(比如 missing["email"] > 5% 就触发邮件)。

真正麻烦的是时间字段和嵌套 JSON 字段——它们的清洗逻辑往往得单独写,没法塞进通用检查函数里。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1771

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4624

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1749

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

27317

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3307

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3307

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1203

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2563

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习