文章目录 利用 Django 输出 CSV 示例出现原因解决方法进一步思考修改 UTF-8 编码为带有 BOM 的UTF-8
利用 Django 输出 CSV 示例
环境：Python3 + Django 2.2.24
代码编辑器默认的编码是 UTF-8
import csvfrom django.http import HttpResponsedef some_view(request): response = HttpResponse(content_type='text/csv') response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' writer = csv.writer(response) writer.writerow(['姓名', '性别', '年龄', '地址']) writer.writerow(['xwdbks', '男', '18', '北京']) return response这样导出文件后，即使文件的编码是 UTF-8，用 Excel 打开 CSV 文件还是乱码；但是用文本编辑器（如记事本）打开后是正常的。
出现原因默认情况下，Windows 平台上的 UTF-8 编码是带有 BOM（Byte Order Mark）的，所以使用 Windows 上的Excel 软件打开纯 UTF-8 编码的文档时，会因为没有 BOM 而不识别文件内容，造成乱码。
UTF-8 不需要 BOM，尽管 Unicode 标准允许在 UTF-8 中使用 BOM。
所以不含 BOM 的 UTF-8 才是标准形式，在 UTF-8 文件中放置 BOM 主要是微软的习惯（顺便提一下：把带有 BOM 的小端序 UTF-16 称作「Unicode」而又不详细说明，这也是微软的习惯）。
BOM（byte order mark）是为 UTF-16 和 UTF-32 准备的，用于标记字节序（byte order）。微软在 UTF-8 中使用 BOM 是因为这样可以把 UTF-8 和 ASCII 等编码明确区分开，但这样的文件在 Windows 之外的操作系统里会带来问题。
使用 Windows 记事本打开导出的文件后，可以看到编码是 UTF-8
解决方法可以在构建 response 对象时设置编码为带有 BOM 的编码格式：utf-8-sig
import csvfrom django.http import HttpResponsedef some_view(request): response = HttpResponse(content_type='text/csv') # 设置带 BOM 的编码 response.charset = 'utf-8-sig' response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' writer = csv.writer(response) writer.writerow(['姓名', '性别', '年龄', '地址']) writer.writerow(['xwdbks', '男', '18', '北京']) return response这样导出文件后可以直接用 Excel 打开而不会乱码；使用 Windows 记事本打开后，显示编码为 带有 BOM 的 UTF-8。
进一步思考可以使用 request 中的 User-Agent 进行客户端系统判断，如果用户的系统是 Windows，那么给导出的文件编码设置为带有 BOM 的 UTF-8，否则使用 UTF-8。
实现示例：
import csvfrom django.http import HttpResponsedef some_view(request): response = HttpResponse(content_type='text/csv') # 通过 User-Agent 判断客户端系统，然后设置带 BOM 的编码 response.charset = 'utf-8-sig' if "Windows" in request.headers.get('User-Agent') else 'utf-8' response['Content-Disposition'] = 'attachment; filename="somefilename.csv"' writer = csv.writer(response) writer.writerow(['姓名', '性别', '年龄', '地址']) writer.writerow(['xwdbks', '男', '18', '北京']) return response 修改 UTF-8 编码为带有 BOM 的UTF-8如果你已经有 CSV 文件的编码是 UTF-8，那么需要另存为新的文件，并设置编码。
如下，使用 Windows 记事本另存为：