如何将SQL查询结果直接导出为CSV格式

导出数据库查询结果到CSV文件，几乎是每个开发者都会遇到的需求。但不同数据库的导出方式差异不小，且不少方案看似简单，用起来却容易踩坑——比如表头没了、中文字符乱码了、Excel里数字变成科学计数法了。这篇文章就梳理几种主流数据库的原生导出方式，以及一个更通用的脚本方案，帮你少走弯路。

MySQL 使用 SELECT ... INTO OUTFILE 导出 CSV

MySQL 原生支持直接将查询结果写入服务器本地文件，核心命令就是 SELECT ... INTO OUTFILE。但注意：它只能写到数据库服务器所在机器的文件系统，执行用户需要具备 FILE 权限，同时受 secure_file_priv 变量限制——可以通过 SHOW VARIABLES LIKE 'secure_file_priv'; 查看允许的路径。

典型用法如下：

SELECT id, name, email FROM users WHERE created_at > '2024-01-01' INTO OUTFILE '/var/lib/mysql-files/users_export.csv'
FIELDS TERMINATED BY ',' ENCLOSED BY '"'
LINES TERMINATED BY 'n';

这里几个参数值得留意：

• FIELDS TERMINATED BY ',' 指定字段分隔符，逗号是 CSV 标准，但也可以换成 ; 或 t（制表符）
• ENCLOSED BY '"' 表示字符串字段用双引号包裹，避免字段内包含逗号或换行导致格式错乱
• LINES TERMINATED BY 'n' 控制行尾，Linux 用 n，Windows 服务器建议用 rn，否则 Excel 可能显示为单行
• 导出路径必须已存在、MySQL 进程有写权限，且不能是相对路径或用户主目录（如 ~/export.csv）

这个方案最大的限制是依赖服务器本地路径，云数据库基本没法直接用。另外需要手动处理中文编码、表头缺失以及特殊字符转义等问题，没有一些脚本工具来得灵活。

PostgreSQL 用 COPY 命令导出查询结果

PostgreSQL 的 COPY 命令同样支持直接导出查询结果，但默认也是写到数据库服务器本地磁盘：COPY (SELECT ...) TO ...。如果想把文件导出到客户端机器，需要用 psql 的元命令 copy（注意大小写不同）。

copy (SELECT id, name, email FROM users WHERE status = 'active') TO '/tmp/export.csv' WITH (FORMAT CSV, HEADER TRUE, DELIMITER ',');

• copy 是 psql 特有的元命令，不是标准 SQL，不能在其他客户端（如 pgAdmin、JDBC）里直接运行
• HEADER TRUE 可加表头，不加则只有数据行
• 路径是客户端所在机器的路径，不是数据库服务器路径
• 若遇到 permission denied，检查目标目录是否可写，且 psql 用户有权限创建该文件

这个方式对于本地临时导出很方便，但自动化脚本中还得依赖 psql 调度。

SQLite 怎么导出 CSV？用 .mode csv + .output

SQLite 命令行工具（sqlite3）没有内置的导出语句，但通过交互模式下的元命令组合也能搞定：

sqlite3 mydb.db> .mode csv
> .headers on
> .output export.csv
> SELECT id, name, email FROM users;
> .output stdout

• .mode csv 启用 CSV 输出格式（自动加引号、转义双引号、用逗号分隔）
• .output 把后续所有查询输出重定向到文件；执行完记得切回 stdout，否则后续命令也会继续写进文件
• 不支持 WHERE 或 LIMIT 动态参数，但可以通过 shell 拼接：echo "SELECT ...;" | sqlite3 mydb.db > export.csv
• 导出文件编码默认是 UTF-8，但 Windows Excel 打开可能出现乱码，可以加 BOM：echo -ne 'xEFxBBxBF' | cat - export.csv > export_bom.csv

这个方法轻量直接，适合快速导出整个表或一小部分数据。

通用方案：用客户端工具或脚本中转

当数据库权限受限（比如云数据库禁止 INTO OUTFILE 或 COPY）、需要导出到本地、或者要增加额外处理（字段映射、空值替换、分页导出等），绕过服务端写文件是最稳妥的做法。

以 Python + pandas 为例：

import pandas as pd
import sqlite3  # 或 pymysql / psycopg2

conn = sqlite3.connect('mydb.db')
df = pd.read_sql_query("SELECT id, name, email FROM users", conn)
df.to_csv('local_export.csv', index=False, encoding='utf-8-sig')

• encoding='utf-8-sig' 是关键：让 Excel 能正确识别 UTF-8 中文，否则大概率乱码
• 大数据量时别一次性读全表，用 chunksize 分批处理，避免内存溢出
• 字段里如果包含换行符、引号、逗号，pandas.to_csv() 默认会正确转义，比手写 CSV 处理可靠得多

回头来看，真正麻烦的从来不是“怎么把数据导出来”，而是导出后 Excel 打不开、中文乱码、数值被自动转成科学计数法。这些都不是 SQL 层能解决的，得从编码、BOM、Excel 自动类型推断入手。选择哪种方案，取决于你的使用场景和权限限制，但至少现在对各个数据库的常用套路心里有数了。