wiki/Tech/programming-language/Python/模块/数据处理/csv 文件读写.md

---
title: csv 文件读写
description: Python 标准库 csv 文件读写
keywords:
  - Python
  - csv
tags:
  - Python/标准库
author: 7Wate
date: 2023-10-20
---

## CSV

### CSV 文件是什么

CSV（Comma Separated Values，字符分隔值）是一种简单的文件格式，用来存储表格数据，如电子表格或数据库。CSV 文件由任意数量的记录组成，记录间以某种换行符分隔。每条记录由字段组成，字段间的分隔符是其他字符或字符串，最常见的是逗号或制表符。

### 用途和优点

CSV 文件常用于数据的导入导出，可以被大多数类型的软件包括文本编辑器和电子表格程序读取。其优点包括**简单、易于阅读、跨平台和语言兼容。**

### 基本结构

CSV 文件由行和列组成。每一行代表一个数据记录，而列则代表该记录的字段。字段的值由逗号分隔，不同的行则由换行符分隔。

```text
name,age,job
John,25,Engineer
Alice,30,Doctor
```

## Python Csv 模块

Python 的 `csv` 模块提供了一种方便的方式来操作 CSV 文件。它包括了用于读取和写入 CSV 数据的函数，以及用于处理 CSV 数据的类。

在 Python 中导入 `csv` 模块只需要简单的 `import` 语句：

```python
import csv
```

### 主要函数和类

`csv` 模块的主要函数和类有：

- `csv.reader()`：生成一个读取器对象，用于迭代读取 CSV 文件的每一行。
- `csv.writer()`：生成一个写入器对象，用于将数据写入 CSV 文件。
- `csv.DictReader()`：生成一个读取器对象，用于以字典形式读取 CSV 文件的每一行。
- `csv.DictWriter()`：生成一个写入器对象，用于将字典数据写入 CSV 文件。

## 读取 CSV 文件

### 使用 csv.reader() 函数读取 CSV 文件

使用 `csv.reader()` 函数读取 CSV 文件的步骤如下：

1. 打开你想要读取的 CSV 文件。
2. 创建一个 `csv.reader` 对象，传入该文件对象作为参数。
3. 迭代 `csv.reader` 对象，读取文件的每一行。

```python
import csv

with open('example.csv', 'r') as file:
    reader = csv.reader(file)
    for row in reader:
        print(row)
```

**读取 CSV 文件时可能遇到的问题包括编码问题、字段格式问题等。**常见解决方法包括指定文件的编码方式、使用 `try-except` 块处理可能出现的错误等。

### CSV 文件的读取实例

假设我们有一个名为 `employees.csv` 的 CSV 文件，内容如下：

```plaintext
name,age,department
John Doe,30,Engineering
Jane Smith,40,Marketing
```

我们可以使用以下代码来读取这个文件：

```python
import csv

with open('employees.csv', 'r') as file:
    reader = csv.reader(file)
    for row in reader:
        print(f'Name: {row[0]}, Age: {row[1]}, Department: {row[2]}')
```

## 写入 CSV 文件

### 使用 csv.writer() 函数写入 CSV 文件

使用 `csv.writer()` 函数写入 CSV 文件的步骤如下：

1. 打开你想要写入的 CSV 文件。
2. 创建一个 `csv.writer` 对象，传入该文件对象作为参数。
3. 使用 `writerow()` 或 `writerows()` 方法，将数据写入文件。

```python
import csv

with open('example.csv', 'w', newline='') as file:
    writer = csv.writer(file)
    writer.writerow(['name', 'age', 'job'])
    writer.writerow(['John', '25', 'Engineer'])
    writer.writerow(['Alice', '30', 'Doctor'])
```

**写入 CSV 文件可能遇到的问题包括权限问题、磁盘空间问题等。**常见解决方法包括检查文件写入权限、确保磁盘有足够空间等。

### CSV 文件的写入实例

假设我们需要将以下数据写入一个名为 `employees.csv` 的 CSV 文件：

```python
employees = [
    ['name', 'age', 'department'],
    ['John Doe', '30', 'Engineering'],
    ['Jane Smith', '40', 'Marketing']
]
```

我们可以使用以下代码来写入这个文件：

```python
import csv

with open('employees.csv', 'w', newline='') as file:
    writer = csv.writer(file)
    writer.writerows(employees)
```

## CSV 数据使用字典处理

### 使用 csv.DictReader() 函数读取 CSV 文件并返回字典

`csv.DictReader()` 函数可以将 CSV 文件的每行读取为一个字典，其中列名为键，列值为值。

```python
import csv

with open('example.csv', 'r') as file:
    reader = csv.DictReader(file)
    for row in reader:
        print(row)
```

### 使用 csv.DictWriter() 函数将字典写入 CSV 文件

`csv.DictWriter()` 函数可以将字典数据写入 CSV 文件。需要先指定列名，然后调用 `writeheader()` 方法写入列名，最后调用 `writerow()` 或 `writerows()` 方法写入字典数据。

```python
import csv

with open('example.csv', 'w', newline='') as file:
    fieldnames = ['name', 'age', 'job']
    writer = csv.DictWriter(file, fieldnames=fieldnames)
    
    writer.writeheader()
    writer.writerow({'name': 'John', 'age': '25', 'job': 'Engineer'})
    writer.writerow({'name': 'Alice', 'age': '30', 'job': 'Doctor'})
```

### 字典和 CSV 数据的交互

假设我们有一个名为 `employees.csv` 的 CSV 文件，内容如下：

```plaintext
name,age,department
John Doe,30,Engineering
Jane Smith,40,Marketing
```

我们可以使用以下代码来读取这个文件，并打印出每个员工的名字和部门：

```python
import csv

with open('employees.csv', 'r') as file:
    reader = csv.DictReader(file)
    for row in reader:
        print(f"Name: {row['name']}, Department: {row['department']}")
```

## CSV 文件中的错误和异常

读取和写入 CSV 文件时可能遇到的错误和异常包括文件不存在、文件不可读写、磁盘空间不足等。可以使用 try-except 结构来捕获和处理这些异常。

```python
import csv

try:
    with open('example.csv', 'r') as file:
        reader = csv.reader(file)
        for row in reader:
            print(row)
except FileNotFoundError:
    print('File not found.')
```

| 错误类型             | 错误描述                           | 解决方案                                        |
| :------------------- | :--------------------------------- | :---------------------------------------------- |
| `FileNotFoundError`  | 找不到指定的文件。                 | 确保文件的路径和名称正确，且文件确实存在。      |
| `PermissionError`    | 没有足够的权限打开文件。           | 确保你有足够的权限访问和修改文件。              |
| `IsADirectoryError`  | 尝试打开的是一个目录，而不是文件。 | 确保指定的路径是文件，而非目录。                |
| `IOError`            | 文件读写出错，例如磁盘空间不足。   | 确保磁盘有足够的空间，文件没有被其他程序锁定。  |
| `csv.Error`          | CSV 文件格式错误。                 | 确保 CSV 文件的格式正确，例如字段是否正确分隔。 |
| `UnicodeDecodeError` | 文件编码问题。                     | 确保文件的编码和你在 Python 中指定的编码一致。  |