Java StringBuilder拼装CSV文件行数据

站在一位Java开发者的角度，用StringBuilder拼接CSV行数据，这事儿看似简单，但坑其实不少。核心问题就一个：怎么正确处理字段里的逗号、换行和双引号。不能简单粗暴地用逗号连接，那很容易搞出格式错误。

简单说，这活儿的关键在于，得严格按照RFC 4180规范来。这个规范就是CSV文件的标准格式，里面规定了，字段里如果出现了特殊字符，必须加双引号包裹并转义。

字段内容含特殊字符时必须加双引号并转义

CSV里，如果字段本身带着逗号、换行符（n）或者双引号（"），那么整个字段就得老老实实被双引号包起来。如果字段里本身就含有双引号，那这个双引号得变成两个双引号（""）来转义。

• 举个例子：原始字段是 张三,"北京,朝阳区"，拼装后应该变成 "张三",""北京,朝阳区""。
• 再比如：原始字段是 备注：他说"很好"，转义后就是 "备注：他说""很好"""。

推荐封装一个安全的 CSV 字段转义方法

为了避免转义逻辑散得到处都是，每次拼接前先对单个字段做标准化处理，是个好习惯。可以封装一个专门的方法，比如叫 escapeCsvField，这样代码更清晰，也更容易维护。

public static String escapeCsvField(String field) {
    if (field == null) return "";
    // 先替换内部双引号为两个双引号
    String escaped = field.replace(""", """");
    // 如果含逗号、换行或本身带双引号，就整体加双引号
    if (escaped.contains(",") || escaped.contains("n") || escaped.contains(""") || escaped.contains("r")) {
        return """ + escaped + """;
    }
    return escaped;
}

用 StringBuilder 逐字段拼接，注意逗号和换行位置

接下来就是用StringBuilder逐字段拼接了。这里有几个细节要注意：不要开头或结尾多加逗号，换行符放在整行末尾，而不是每个字段后面。

• 先初始化 StringBuilder sb = new StringBuilder();
• 对每个字段调用 escapeCsvField()，然后用 sb.append(escaped).append(","); 拼接。
• 最后一定要去掉末尾多余的逗号：if (sb.length() > 0) sb.setLength(sb.length() - 1);
• 再追加换行符：sb.append("n");

完整示例行拼装示例

比如，要拼一行用户数据：id=123, name="张三", city="北京,朝阳区", remark="他说"棒极了""

StringBuilder sb = new StringBuilder();
sb.append(escapeCsvField("123")).append(",");
sb.append(escapeCsvField("张三")).append(",");
sb.append(escapeCsvField("北京,朝阳区")).append(",");
sb.append(escapeCsvField("他说"棒极了""));
if (sb.length() > 0) sb.setLength(sb.length() - 1); // 删末尾逗号
sb.append("n");
// 结果："123","张三","北京,朝阳区","他说""棒极了"""

其实不复杂，但就是容易忽略掉这些细节，导致生成的CSV文件出问题。多注意一下，就能避免很多麻烦。