Python csv 模块基础：读写表格文件

文章目录前言一、先搞懂csv到底是什么别被文件后缀唬住二、前置准备csv模块零安装导入即用三、csv文件读取3种常用方式小白全拿捏3.1 基础逐行读取reader()函数入门首选核心语法代码示例代码逐行白话解释运行结果3.2 字典式读取DictReader()按列名取数更省心核心语法代码示例运行结果3.3 大文件批量读取避免内存溢出四、csv文件写入2种核心写法新建/追加全搞定4.1 基础写入writer()函数新建csv文件核心语法代码示例新建写入多行新手必看重点4.2 字典式写入DictWriter()按表头写入不错位核心语法代码示例4.3 追加写入不覆盖原有数据实用必备追加写入代码示例五、2026年小白必避csv模块5大高频坑坑1中文乱码坑2写入文件有空行坑3文件路径找不到坑4数据含逗号/引号自动拆分列坑5用w模式误删原有数据六、实战案例简易学生成绩统计系统运行结果七、csv模块选型建议什么时候用它最合适结语P.S. 目前国内还是很缺AI人才的希望更多人能真正加入到AI行业共同促进行业进步增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow教程通俗易懂高中生都能看懂还有各种段子风趣幽默从深度学习基础原理到各领域实战应用都有讲解我22年的AI积累全在里面了。注意教程仅限真正想入门AI的朋友否则看看零散的博文就够了。前言在Python日常开发、数据处理、爬虫存储、简易办公自动化等场景里表格文件的处理绝对是绕不开的刚需。提到表格很多新手第一反应就是Excel可真要上手处理简单的表格数据才发现Excel文件格式臃肿、依赖第三方库、还容易出现格式兼容问题折腾半天反而耽误效率。其实Python早就自带了一款「极简表格处理神器」——csv模块作为Python内置的标准库它不需要额外安装任何依赖兼容性拉满2026年主流的Python3.10及以上版本都能无缝使用专门用来处理csv格式的表格文件完全能满足90%以上的简单表格读写需求。很多新手觉得csv模块操作复杂其实是没找对学习思路它的核心逻辑就像我们日常手写表格一样简单读就是照着表格念数据写就是往表格里填内容。这篇文章我就用最通俗的大白话接地气的段子从零开始带大家吃透csv模块的基础读写操作全程无晦涩术语、无复杂逻辑零基础小白也能一步跟着上手看完就能直接用到实际代码里。一、先搞懂csv到底是什么别被文件后缀唬住在正式学习csv模块之前咱们先把csv文件的本质掰扯清楚避免新手一上来就陷入「格式误区」。很多人看到.csv后缀就觉得它是Excel的专属格式这完全是误解csv的全称是Comma-Separated Values翻译过来就是「逗号分隔值」说白了就是纯文本格式的简易表格和Excel那种带公式、带字体格式、带颜色排版的复杂表格完全不是一回事。我给大家打个比方如果把Excel比作装修精致、功能齐全的精装餐厅那csv就是路边干净整洁、只卖家常菜的便民小吃店——没有花里胡哨的装饰没有多余的功能只有最核心的「数据内容」用逗号把每一列数据分开用换行代表每一行数据结构简单到极致。举个最直观的例子一个学生成绩的csv文件用记事本打开长这样姓名,语文,数学,英语 张三,92,88,95 李四,85,90,89 王五,78,82,91用Excel打开就是规整的表格本质上它就是一段纯文本只是用固定的分隔符区分行列这也是csv文件最大的优势跨平台兼容Windows、Mac、Linux系统都能直接打开不存在格式兼容问题轻量无负担同样的数据量csv文件体积只有Excel的十分之一甚至更小打开、读写速度极快无依赖易处理Python原生模块就能操作不用安装第三方库避免依赖冲突、版本不兼容的问题。2026年的开发场景中小批量数据存储、爬虫数据导出、简易数据交换、办公简单表格统计首选都是csv格式根本没必要动用pandas、openpyxl这类重型库就像你出门买瓶矿泉水没必要开大型货车骑个电动车csv模块就足够了。二、前置准备csv模块零安装导入即用作为Python内置的标准库csv模块最大的亮点就是无需额外安装不管你是Windows、Mac还是Linux系统只要安装了Python环境就能直接导入使用完全不用执行pip install命令彻底告别新手最头疼的「依赖安装报错」问题。导入csv模块的代码只有一行简单到离谱# 导入csv模块全程只需这一行importcsv这里给新手提个醒2026年市面上已经几乎没人用Python2了csv模块在Python3中做了优化语法和使用逻辑更简单本文所有代码都是基于Python3.10版本编写大家直接复制运行即可不用考虑版本兼容问题。很多新手会问「我要不要装别的库辅助」完全不用csv模块本身就封装了完整的读写、格式处理功能咱们处理基础表格吃透原生csv模块就够了别还没学会走路就想着跑先把基础打牢比什么都重要。三、csv文件读取3种常用方式小白全拿捏读取csv文件是日常使用最多的操作比如读取本地的成绩表、数据表、爬虫导出的数据等csv模块提供了两种核心读取方式再加上进阶的批量读取刚好覆盖新手所有使用场景下面逐一拆解每一种都配代码白话解释。3.1 基础逐行读取reader()函数入门首选csv.reader()是csv模块最基础的读取方法适合没有复杂格式、纯数据的csv文件它会把csv文件的每一行数据转换成一个列表我们通过遍历就能拿到每一行的内容。核心语法代码示例# 第一步打开csv文件with语句会自动关闭文件不用手动写close()withopen(student.csv,r,encodingutf-8)ascsv_file:# 第二步创建reader对象相当于给文件配个「翻译官」csv_readercsv.reader(csv_file)# 第三步遍历reader对象逐行读取数据forrowincsv_reader:# 每一行row都是一个列表对应表格的一行print(row)代码逐行白话解释with open(...)打开文件的固定写法with是Python的语法糖作用是自动关闭文件新手不用记文件关闭操作避免出现文件占用、数据丢失的问题r代表只读模式专门用来读取文件不能修改encodingutf-8指定文件编码为UTF-8这行千万不能少2026年Windows系统默认编码是GBK不指定UTF-8一定会出现中文乱码这是新手第一大坑csv.reader(csv_file)创建读取对象把csv文件的纯文本转换成可遍历的列表数据for row in csv_reader逐行遍历每循环一次就拿到一行表格数据存到row列表里。运行结果运行上面的代码读取之前的学生成绩表输出结果如下[姓名, 语文, 数学, 英语] [张三, 92, 88, 95] [李四, 85, 90, 89] [王五, 78, 82, 91]可以看到表头和每一行数据都变成了列表想拿某一列数据直接用索引就行比如拿姓名就是row[0]拿语文成绩就是row[1]。3.2 字典式读取DictReader()按列名取数更省心csv.DictReader()是新手更推荐的读取方式尤其适合带表头的csv文件它不会把行转成普通列表而是转成字典字典的键就是表格的表头值就是对应的数据再也不用记繁琐的列表索引看名字就能取数简直是新手福音。核心语法代码示例withopen(student.csv,r,encodingutf-8)ascsv_file:# 创建DictReader对象自动把第一行作为表头csv_dict_readercsv.DictReader(csv_file)# 遍历读取每一行数据forrowincsv_dict_reader:# 直接通过列名取数不用记索引print(f姓名{row[姓名]}语文成绩{row[语文]}数学成绩{row[数学]})运行结果姓名张三语文成绩92数学成绩88 姓名李四语文成绩85数学成绩90 姓名王五语文成绩78数学成绩82这种方式就像给每个数据贴了「标签」再也不会出现「索引记错取错数据」的问题比如想拿英语成绩直接写row[英语]就行可读性直接拉满新手优先用这种方法3.3 大文件批量读取避免内存溢出很多新手觉得csv只能处理小文件其实不然2026年处理几十万行的中型csv文件用csv模块逐行读取也完全不会卡顿。因为reader()和DictReader()都是逐行加载数据不会一次性把整个文件读到内存里就像我们吃饭一口一口吃不会一口吞完自然不会出现内存溢出的问题。这里给新手一个实用技巧如果文件行数特别多不想打印全部数据可以加一个计数器读取前N行测试withopen(student.csv,r,encodingutf-8)ascsv_file:csv_readercsv.reader(csv_file)# 计数器count0forrowincsv_reader:# 只打印前3行数据ifcount3:print(row)count1else:break四、csv文件写入2种核心写法新建/追加全搞定学会了读接下来就是写数据csv模块的写入操作同样简单分为新建文件写入和原有文件追加写入对应两种写入方法新手只要分清写入模式再也不会踩坑。4.1 基础写入writer()函数新建csv文件csv.writer()是基础写入方法用来新建csv文件并写入数据分为写入单行和写入多行核心是要注意文件打开模式和换行参数。核心语法代码示例新建写入多行# 定义要写入的学生成绩数据student_data[[姓名,语文,数学,英语],[张三,92,88,95],[李四,85,90,89],[王五,78,82,91]]# 打开文件w代表写入模式新建文件/覆盖原有文件withopen(student.csv,w,encodingutf-8,newline)ascsv_file:# 创建写入对象csv_writercsv.writer(csv_file)# 写入多行数据writerow写入单行writerows写入多行csv_writer.writerows(student_data)print(csv文件写入完成)新手必看重点newline千万不能少这是Python3写入csv的核心参数不加这个参数写入的文件每一行之间会出现空行2026年所有Python3版本都需要加这个参数彻底解决空行问题**w模式覆盖写入**如果文件已经存在用’w’模式会直接清空原有内容重新写入相当于把原来的表格擦掉重写新手一定要谨慎writerow()写入单行数据适合逐行添加内容writerows()写入多行数据适合批量导入。4.2 字典式写入DictWriter()按表头写入不错位和读取对应写入也有字典式写入方法csv.DictWriter()适合按列名写入数据不用手动对齐列表顺序彻底避免列错位问题适合数据结构固定的场景。核心语法代码示例# 定义表头field_names[姓名,语文,数学,英语]# 定义要写入的字典数据student_dict_data[{姓名:张三,语文:92,数学:88,英语:95},{姓名:李四,语文:85,数学:90,英语:89},{姓名:王五,语文:78,数学:82,英语:91}]withopen(student_dict.csv,w,encodingutf-8,newline)ascsv_file:# 创建字典写入对象指定表头csv_writercsv.DictWriter(csv_file,fieldnamesfield_names)# 写入表头csv_writer.writeheader()# 写入多行数据csv_writer.writerows(student_dict_data)这种方式的好处是哪怕字典里的键顺序乱了写入csv后也会按照指定的表头顺序排列再也不会出现「姓名写到数学列」的低级错误对新手极其友好。4.3 追加写入不覆盖原有数据实用必备很多时候我们需要往已有的csv文件里添加新数据而不是覆盖原有内容这时候只需要把文件打开模式从w改成**a追加模式**其他代码完全不变追加写入代码示例# 要追加的新学生数据new_student[[赵六,88,95,90]]withopen(student.csv,a,encodingutf-8,newline)ascsv_file:csv_writercsv.writer(csv_file)csv_writer.writerows(new_student)print(数据追加完成)运行后原有的学生数据不会丢失直接在表格最后一行添加赵六的成绩这是日常开发中最常用的写入方式比如爬虫每爬取一条数据就追加一次完全不用担心里程数据丢失。五、2026年小白必避csv模块5大高频坑新手用csv模块90%的报错都是因为踩了这几个坑我把2026年粉丝反馈最多的问题整理出来逐个给解决办法看完再也不用百度搜报错。坑1中文乱码报错表现打印或者写入的中文变成乱码、问号解决办法所有文件操作都加上encodingutf-8如果还是乱码换成encodingutf-8-sigWindows系统专属解决永远别用默认编码。坑2写入文件有空行报错表现csv文件每一行数据之间有空白行解决办法写入文件时open()函数必须加newline参数这是Python3的固定要求没有例外。坑3文件路径找不到报错表现FileNotFoundError解决办法新手优先用相对路径把csv文件和Python代码放在同一个文件夹里直接写文件名如果用绝对路径Windows系统路径用/或者\\别用单个\。坑4数据含逗号/引号自动拆分列问题表现数据里有逗号写入后被拆成两列解决办法不用手动处理csv模块会自动给包含分隔符的字段添加引号保证数据不拆分新手完全不用操心转义问题。坑5用w模式误删原有数据问题表现原有表格数据全部消失解决办法修改已有文件用a追加模式新建文件用w模式养成先看模式再写代码的习惯。六、实战案例简易学生成绩统计系统咱们把前面学的读写操作结合起来做一个完整的小案例写入学生成绩→读取成绩→筛选及格学生代码直接复制就能运行新手看完就能上手实战。importcsv# 1. 写入学生成绩数据score_data[[姓名,语文,数学,英语],[张三,92,58,95],[李四,85,90,89],[王五,78,82,55],[赵六,88,95,90]]withopen(score.csv,w,encodingutf-8,newline)asf:writercsv.writer(f)writer.writerows(score_data)# 2. 读取并筛选数学及格≥60分的学生print(数学及格的学生)withopen(score.csv,r,encodingutf-8)asf:readercsv.DictReader(f)forrowinreader:# 注意读取的数据是字符串需要转成整数比较math_scoreint(row[数学])ifmath_score60:print(f姓名{row[姓名]}数学成绩{math_score})运行结果数学及格的学生 姓名李四数学成绩90 姓名王五数学成绩82 姓名赵六数学成绩95这个案例涵盖了csv模块的核心读写操作还解决了「字符串转数字」的小细节新手完全可以在此基础上扩展比如统计平均分、筛选各科及格学生轻松实现简易办公自动化。七、csv模块选型建议什么时候用它最合适最后给新手一个清晰的选型思路避免大家盲目选择库用csv模块的场景处理简单纯文本表格、小批量数据、无格式要求、不想装第三方库、跨平台数据交换不用csv模块的场景处理带公式/格式的Excel文件、大数据量分析、复杂数据计算这种情况再用pandas、openpyxl。说白了csv模块就是Python表格处理的「入门神器」轻便、简单、无依赖新手先吃透它再去学更复杂的库循序渐进才是最快的学习方式。结语Python csv模块看似基础却是日常开发中使用率极高的工具没有复杂的语法没有繁琐的依赖只要掌握读写的核心方法、避开几个常见坑就能轻松搞定绝大多数简单表格处理需求。学习Python不要一味追求高大上的库把原生基础模块吃透反而能解决大部分实际问题就像csv模块看似不起眼却能让你的数据处理效率翻倍。希望这篇文章能帮到零基础小白彻底搞定csv文件的读写操作后续我会继续分享Python实用基础模块带大家一步步夯实Python编程基础。P.S. 目前国内还是很缺AI人才的希望更多人能真正加入到AI行业共同促进行业进步增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow教程通俗易懂高中生都能看懂还有各种段子风趣幽默从深度学习基础原理到各领域实战应用都有讲解我22年的AI积累全在里面了。注意教程仅限真正想入门AI的朋友否则看看零散的博文就够了