推荐使用OpenCSV写入CSV文件，因其能自动处理逗号、换行、引号及中文等特殊字符，并支持自定义分隔符、Bean映射和UTF-8编码；手写方式仅适用于无特殊字符且无第三方依赖限制的极简场景。
Java 写入 CSV 文件，用 OpenCSV 更省心、更可靠，尤其当数据含逗号、换行、引号或中文时。纯手写（比如用 FileWriter + StringBuilder）看似简单，但容易出错，维护成本高。
为什么推荐 OpenCSV？
OpenCSV 是专为 CSV 设计的成熟库，自动处理：
- 字段中含逗号（如
"Zhang, Wei"→ 自动加双引号包裹 - 字段中含换行符（如地址栏含回车）→ 正确换行并转义
- 字段含双引号（如
He said "OK"→ 转义为"He said ""OK""" - 支持自定义分隔符、引号符、换行符（兼容 Windows/macOS/Linux）
- 内置 Bean 映射，对象列表可直接写入，不用手动拼字符串
不用 OpenCSV 的情况（极少数）
仅当项目有严格限制（如：禁止引入任何第三方依赖、CSV 结构极其固定、字段绝对不含特殊字符、且只写几行简单数据）时，才考虑手写。例如：
try (FileWriter w = new FileWriter("data.csv")) {
w.write("name,age\n");
w.write("Alice,25\n");
w.write("Bob,30\n");
}
⚠️ 一旦 name 是 Alice, Jr. 或 Bob\n25，就乱了——你得自己判断是否加引号、是否转义，很快就不“简单”了。
立即学习“Java免费学习笔记（深入）”；
用 OpenCSV 写入的典型做法
Maven 引入：
<dependency> <groupId>com.opencsv</groupId> <artifactId>opencsv</artifactId> <version>5.7.1</version> </dependency>
写入示例（带 header 的 List<String[]>）：
try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
writer.writeNext(new String[]{"姓名", "城市", "备注"});
writer.writeNext(new String[]{"张三", "上海", "喜欢\"咖啡\""});
writer.writeNext(new String[]{"李四", "深圳", "换行\n测试"});
}
写入 JavaBean（自动映射字段）：
List<User> users = Arrays.asList(
new User("王五", 28, "杭州"),
new User("赵六", 32, "北京")
);
try (CSVWriter writer = new CSVWriter(new FileWriter("users.csv"))) {
StatefulBeanToCsv<User> beanWriter = new StatefulBeanToCsvBuilder<>(writer)
.withQuotechar(CSVWriter.NO_QUOTE_CHARACTER) // 可选：禁用引号
.build();
beanWriter.write(users);
}
小提醒：别忽略编码和关闭资源
中文写入务必指定 UTF-8 编码：
new FileWriter("out.csv", StandardCharsets.UTF_8) // ✅
// 不要用 new FileWriter("out.csv") // ❌ 默认平台编码，Windows 上中文易乱码
务必用 try-with-resources 自动关闭，避免文件锁死或内容未刷盘。
基本上就这些。OpenCSV 不重、不难、不坑——它解决的正是 CSV 那些“看似简单实则琐碎”的细节问题。
