0

0

深入理解Python列表在CSV文件中的写入机制

碧海醫心

碧海醫心

发布时间:2025-11-25 13:40:02

|

950人浏览过

|

来源于php中文网

原创

深入理解Python列表在CSV文件中的写入机制

python列表通过`csv`模块写入csv文件时,它并不会以原生列表对象的形式存储。`csv`模块的默认行为是将所有非字符串数据类型隐式地通过`str()`函数转换为其字符串表示。这意味着一个python列表,包括其方括号和内部元素,将作为一个完整的文本字符串写入csv单元格,例如显示为`['item1', 'item2']`。理解这一字符串化过程对于正确地进行数据序列化和反序列化至关重要。

csv 模块的数据处理机制

Python的内置csv模块是处理CSV(Comma Separated Values)文件的强大工具。在将数据写入CSV文件时,一个常见的疑问是:当遇到非字符串类型的数据(如整数、浮点数、布尔值,尤其是复杂类型如列表或字典)时,模块会如何处理?

根据Python官方文档对csv模块的描述,其核心处理原则是:

除None和str类型本身外,所有其他非字符串数据在写入之前都会通过str()函数进行字符串化。

这意味着,无论是数字、日期对象,还是更复杂的数据结构如列表、元组或自定义对象,在被写入CSV文件之前,它们都会被转换为其对应的字符串表示形式。这个转换是通过调用该对象的__str__方法实现的,如果该方法未定义,则会回退到默认的repr()方法。

Python 列表的写入行为详解

当一个Python列表被作为行元素传递给csv.writer对象进行写入时,它会遵循上述的通用规则。列表对象会被其自身的str()实现转换为一个字符串。例如,对于列表['apple', 'banana', 'cherry'],其str()表示将是"['apple', 'banana', 'cherry']"。这个完整的字符串,包括外部的方括号和内部元素的引号,将作为一个单一的文本值存储在CSV文件的一个单元格中。

立即学习Python免费学习笔记(深入)”;

示例:

假设我们有一个包含列表的行数据,并希望将其写入CSV文件:

家饰网上商城系统
家饰网上商城系统

虚拟主机或在自备服务器中开设好的主机空间,主机环境要求:PHP4.3-5.x/非安全模式/允许WEB文件上传MYSQL4.2-5.xzend optimizer 3.2以上安装方法:1、将安装包解压后,将全部文件和目录上传到网站空间根目录, 用FTP上传时必须采用二进制方式。2、运行http://您的域名/(安装向导),或者进入网站安装http://您的域名/base/install/,填写MYS

下载
import csv

data_to_write = [
    ['Header1', 'Header2', 'Header3'],
    ['Row1_Item1', 123, ['list_item_a', 'list_item_b']],
    ['Row2_Item1', 456, ['another_list_item']]
]

file_name = 'example.csv'

with open(file_name, 'w', newline='', encoding='utf-8') as csvfile:
    writer = csv.writer(csvfile)
    writer.writerows(data_to_write)

print(f"数据已写入 {file_name}")

打开生成的example.csv文件,你可能会看到如下内容(取决于你的CSV查看器和分隔符设置):

Header1,Header2,Header3
Row1_Item1,123,"['list_item_a', 'list_item_b']"
Row2_Item1,456,"['another_list_item']"

注意第三列中列表是如何被引号包围并作为单个字符串存储的。这是因为csv模块在写入时会自动处理引号和分隔符,以确保字符串中的逗号或特殊字符不会破坏CSV结构。

从CSV文件读取并恢复列表

由于列表是以字符串形式存储的,当从CSV文件读取这些数据时,它们仍然是字符串类型。要将这些字符串恢复为原始的Python列表对象,需要进行额外的解析步骤。直接使用eval()函数虽然可以实现,但存在安全风险(因为它会执行任意代码)。更安全和推荐的方法是使用ast.literal_eval()。

示例:

import csv
import ast

file_name = 'example.csv'
read_data = []

with open(file_name, 'r', newline='', encoding='utf-8') as csvfile:
    reader = csv.reader(csvfile)
    for row in reader:
        # 假设列表总是在第三列
        if len(row) > 2:
            try:
                # 尝试将第三列的字符串转换为Python对象
                # 仅当字符串看起来像一个Python字面量时才尝试转换
                if row[2].startswith('[') and row[2].endswith(']'):
                    row[2] = ast.literal_eval(row[2])
                # 如果是数字,也可以尝试转换
                if row[1].isdigit():
                    row[1] = int(row[1])
            except (ValueError, SyntaxError):
                # 处理转换失败的情况,例如它不是一个有效的列表字符串
                pass
        read_data.append(row)

# 打印读取并转换后的数据
for row in read_data:
    print(row)

# 验证恢复后的列表类型
if len(read_data) > 1 and len(read_data[1]) > 2:
    print(f"\n第二行第三列的数据类型: {type(read_data[1][2])}")

输出将显示数据已成功读取,并且原来作为字符串存储的列表现在已恢复为Python列表对象:

['Header1', 'Header2', 'Header3']
['Row1_Item1', 123, ['list_item_a', 'list_item_b']]
['Row2_Item1', 456, ['another_list_item']]

第二行第三列的数据类型: 

注意事项与最佳实践

  1. 数据类型的一致性: 确保在读取时对预期为列表的列进行一致的ast.literal_eval转换。
  2. 错误处理: 使用try-except块处理ast.literal_eval可能引发的ValueError或SyntaxError,以防CSV文件中的数据格式不正确。
  3. 替代方案: 如果需要在CSV中存储更复杂的结构化数据(如嵌套列表、字典),并且希望避免手动解析字符串,可以考虑以下方法:
    • JSON 序列化: 在写入CSV之前,将列表或字典转换为JSON字符串。JSON是一种通用的数据交换格式,Python的json模块可以方便地进行序列化和反序列化。
      import json
      my_list = ['item1', {'key': 'value'}]
      json_string = json.dumps(my_list) # "['item1', {'key': 'value'}]"
      # 写入CSV
      # 从CSV读取后
      recovered_list = json.loads(json_string)
    • 自定义分隔符: 如果列表元素本身不包含逗号,可以考虑将列表元素用自定义分隔符(如|)连接成一个字符串,写入CSV。读取时再用split()方法拆分。但这仅适用于简单情况。
    • 多列存储: 将列表的每个元素存储在CSV的不同列中。这会增加列的数量,但可以保持每列数据的原子性。

总结

Python的csv模块在处理非字符串数据时,会将其通过str()函数转换为字符串形式。对于列表而言,这意味着整个列表(包括方括号和元素)会以文本字符串的形式存储在CSV单元格中。在读取时,需要使用ast.literal_eval()等安全的方法将这些字符串恢复为Python列表对象。理解这一机制对于正确地在Python程序和CSV文件之间进行数据交换至关重要,同时,对于更复杂的数据结构,可以考虑使用JSON序列化作为更健壮的解决方案。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

753

2023.06.15

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

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

636

2023.07.20

python能做什么
python能做什么

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

758

2023.07.25

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

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

618

2023.07.31

python教程
python教程

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

1262

2023.08.03

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

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

547

2023.08.04

python eval
python eval

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

577

2023.08.04

scratch和python区别
scratch和python区别

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

707

2023.08.11

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.7万人学习

Django 教程
Django 教程

共28课时 | 3.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号