Python利用 utf-8-sig 编码格式解决写入 csv 文件乱码问题

以下是Python利用 utf-8-sig 编码格式解决写入 csv 文件乱码问题的完整攻略。

什么是 utf-8-sig 编码格式？

在介绍解决乱码问题之前，我们先来了解一下 utf-8-sig 编码格式。utf-8-sig 和 utf-8 编码格式非常类似，都是一种常见的Unicode编码格式，不同的是utf-8-sig会在文件开头添加一个BOM(Byte Order Mark)的标识，用于标记文件的编码方式。这个标识不会影响编码过程，但是可以帮助识别并正确读取文件的编码方式。

写入 csv 文件时出现乱码问题

在Python写入 csv 文件时，如果文件中存在中文字符或者特殊符号，会出现乱码问题。这是因为 csv 文件默认使用的编码是 ASCII 或 ISO-8859-1，而这些编码方式并不支持中文字符的显示。

利用 utf-8-sig 编码格式解决写入 csv 文件乱码问题

要解决写入 csv 文件乱码问题，我们需要使用 utf-8-sig 编码格式来写入文件。步骤如下：

1. 使用 codecs 模块打开文件，并指定编码方式为 utf-8-sig：

   ```
   import codecs

   with codecs.open("example.csv", "w", "utf-8-sig") as f:
   f.write("列1,列2,列3\n")
   f.write("数据1,数据2,数据3\n")
   ```

2. 使用 csv 模块写入文件时，指定文件的 newline 参数为 ''，这可以避免 Windows 下写入文件时换行符自动转换导致乱码：

   ```
   import csv

   with open("example.csv", "w", newline='', encoding="utf-8-sig") as f:
   writer = csv.writer(f)
   writer.writerow(["列1", "列2", "列3"])
   writer.writerow(["数据1", "数据2", "数据3"])
   ```

注意：在使用以上两种方法写入 csv 文件时，要确保文件的编码方式与代码中指定的编码方式一致。如果文件的编码方式不是 utf-8-sig，那么在读取这个文件时可能依然会出现乱码问题。

示例

以下是两个使用 utf-8-sig 编码格式写入 csv 文件的示例：

使用 codecs 模块写入 csv 文件

import codecs

with codecs.open("example.csv", "w", "utf-8-sig") as f:
    f.write("姓名,性别,年龄\n")
    f.write("张三,男,25\n")
    f.write("李四,女,30\n")

使用 csv 模块写入 csv 文件

import csv

with open("example.csv", "w", newline='', encoding="utf-8-sig") as f:
    writer = csv.writer(f)
    writer.writerow(["姓名", "性别", "年龄"])
    writer.writerow(["张三", "男", "25"])
    writer.writerow(["李四", "女", "30"])

注意：在实际使用中，可以根据自己的需要使用更多的列和行，只需要保持编码方式正确就可以避免乱码问题了。