
第五章 文件处理
Pandas 提供了强大而灵活的文件 I/O 功能,能够轻松读写多种格式的数据文件。本文将对 CSV、Excel、JSON 三种最常用的格式进行详细、具体、实战导向的介绍,包括:
read_*)to_*)CSV(Comma-Separated Values)是数据分析中最通用的文本格式。
pd.read_csv()import pandas as pd
df = pd.read_csv('data.csv')参数 | 说明 | 示例 |
|---|---|---|
| 文件路径或 URL |
|
| 分隔符(默认 |
|
| 指定列名行(默认 |
|
| 自定义列名 |
|
| 指定某列作为行索引 |
|
| 只读取部分列 |
|
| 指定列数据类型 |
|
| 解析日期列 |
|
| 文件编码 |
|
| 自定义缺失值标识 |
|
| 跳过开头若干行 |
|
| 仅读前 N 行(调试用) |
|
| 分块读取(大文件) |
|
# 读取含中文的 CSV(常见于 Windows 导出)
df = pd.read_csv('员工表.csv', encoding='gbk')
# 自定义缺失值 + 指定类型
df = pd.read_csv(
'data.csv',
na_values=['-', 'N/A'],
dtype={'user_id': 'str', 'score': 'float32'},
parse_dates=['login_time']
)💡 提示:若遇
UnicodeDecodeError,尝试encoding='latin1'或chardet库检测编码。
df.to_csv()df.to_csv('output.csv', index=False) # 通常不保存行索引参数 | 说明 |
|---|---|
| 输出路径 |
| 分隔符(默认 |
| 是否写入行索引(默认 |
| 编码(如 |
| 缺失值表示(默认空,可设为 |
| 日期格式(如 |
| 浮点数格式(如 |
df.to_csv('result.csv',
index=False,
encoding='utf-8-sig', # 避免 Excel 打开中文乱码
na_rep='N/A',
date_format='%Y/%m/%d')Excel(.xlsx, .xls)适合小规模结构化数据交互,但不适合大数据(性能差、体积大)。
⚠️ 需安装额外依赖:pip install openpyxl # .xlsx 支持(推荐) pip install xlrd # .xls 支持(旧版)
pd.read_excel()df = pd.read_excel('report.xlsx') # 默认读第一个 sheet参数 | 说明 | |
|---|---|---|
| 文件路径 | |
| 工作表名或索引 |
|
| 列名行(同 CSV) | |
| 读取列范围 |
|
| 跳过行数 | |
| 读取行数 | |
| 指定类型 | |
| 引擎( |
# 读取多个 sheet
sheets = pd.read_excel('data.xlsx', sheet_name=['用户', '订单'])
# 读取特定区域
df = pd.read_excel('file.xlsx', sheet_name='Data', usecols='B:D', skiprows=2, nrows=100)✅ 技巧:若 Excel 中有合并单元格,Pandas 会将其上方/左侧值填充,可能需后处理。
df.to_excel()df.to_excel('output.xlsx', index=False)ExcelWriter):with pd.ExcelWriter('report.xlsx', engine='openpyxl') as writer:
df1.to_excel(writer, sheet_name='用户', index=False)
df2.to_excel(writer, sheet_name='订单', index=False)
df_summary.to_excel(writer, sheet_name='汇总', index=False)参数 | 说明 |
|---|---|
| 工作表名 |
| 是否写入索引 |
| 写入起始位置(用于追加到已有模板) |
| 冻结窗格(如 |
with pd.ExcelWriter('template.xlsx', mode='a', if_sheet_exists='replace') as writer:
df.to_excel(writer, sheet_name='Data', startrow=2, header=False, index=False)⚠️ 注意
:mode='a' 表示追加,if_sheet_exists='replace' 覆盖同名 sheet(需 pandas ≥ 1.4.0)
JSON(JavaScript Object Notation)常用于 API 数据交换和 Web 应用。
pd.read_json()[{"col1": a, "col2": b}, ...] → 推荐{"col1": [a, ...], "col2": [b, ...]}df = pd.read_json('data.json')参数 | 说明 | |
|---|---|---|
| 文件路径或 JSON 字符串 | |
| JSON 结构方向 |
|
| 类型推断控制 | |
| 编码(如 | |
| 每行一个 JSON 对象(NDJSON 格式) |
|
# 读取每行一个 JSON(日志常见)
df = pd.read_json('logs.jsonl', lines=True)
# 指定 orient(若自动推断失败)
df = pd.read_json('data.json', orient='records')🔍 如何判断
orient?若 JSON 是 对象数组 →'records'若 JSON 是 列名映射到值数组 →'columns'
df.to_json()df.to_json('output.json', orient='records', indent=2)参数 | 说明 |
|---|---|
| 输出格式(推荐 |
| 缩进(美化输出) |
| 日期格式( |
| 是否转义非 ASCII 字符(中文设为 |
| 每行一个 JSON(用于流式处理) |
# 输出带缩进、支持中文的 JSON
df.to_json('result.json',
orient='records',
indent=2,
force_ascii=False,
date_format='iso')utf-8gbk 或 gb2312utf-8-sig(带 BOM)chunksize 分块for chunk in pd.read_csv('huge.csv', chunksize=10000):
process(chunk)lines=True 流式读取dtype 明确指定(避免自动转 object)'Int64'(可空整型)pd.read_csv(..., dtype={'user_id': 'Int64'})parse_dates 而非后续 pd.to_datetimedate_parser(pandas ≥ 2.0 已弃用,改用 date_format)格式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
CSV | 轻量、通用、高效 | 不支持多表、无格式 | 数据交换、中间存储 |
Excel | 人类友好、支持多表/公式 | 体积大、性能差、依赖引擎 | 小数据交付、报表 |
JSON | 结构灵活、Web 友好 | 体积大、无标准 schema | API、日志、嵌套数据 |
💡 最佳实践建议:日常分析用 CSV 交付业务用 Excel 接收 API 数据用 JSON 超大数据考虑 Parquet/HDF5(Pandas 也支持)
python过渡项目部分代码已经上传至gitee,后续会逐步更新。
公众号:咚咚王
《Python编程:从入门到实践》
《利用Python进行数据分析》
《算法导论中文第三版》
《概率论与数理统计(第四版) (盛骤) 》
《程序员的数学》
《线性代数应该这样学第3版》
《微积分和数学分析引论》
《(西瓜书)周志华-机器学习》
《TensorFlow机器学习实战指南》
《Sklearn与TensorFlow机器学习实用指南》
《模式识别(第四版)》
《深度学习 deep learning》伊恩·古德费洛著 花书
《Python深度学习第二版(中文版)【纯文本】 (登封大数据 (Francois Choliet)) (Z-Library)》
《深入浅出神经网络与深度学习+(迈克尔·尼尔森(Michael+Nielsen)》
《自然语言处理综论 第2版》
《Natural-Language-Processing-with-PyTorch》
《计算机视觉-算法与应用(中文版)》
《Learning OpenCV 4》
《AIGC:智能创作时代》杜雨+&+张孜铭
《AIGC原理与实践:零基础学大语言模型、扩散模型和多模态模型》
《从零构建大语言模型(中文版)》
《实战AI大模型》
《AI 3.0》
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。