Ruby使用CSV.generate生成CSV时换行符未被识别的问题如何解决

问题原因 #

• 代码存在编码声明笔误：配置项中写的UTF=8是错误格式，正确应为UTF-8，异常的编码声明会导致部分软件解析CSV格式出错。
• Ruby CSV.generate默认使用\n（LF）作为行分隔符，Windows平台下的Excel、WPS等主流办公软件默认仅识别\r\n（CRLF）为行分隔符，因此无法正确识别换行，将所有内容展示在同一行。

解决方案 #

不需要更换CSV生成方案，只需在CSV.generate的配置项中补充行分隔符参数，同时修正编码笔误即可：

csv = CSV.generate(encoding: 'UTF-8', row_sep: "\r\n") do |csv_out|
   csv_out << headers
   data.each do |row|
      csv_out << row.values
   end
end

额外排查点 #

如果修改后仍存在格式问题，可检查以下两点：

• 确认业务数据row.values的单个字段中无多余换行符：如果字段本身包含换行，CSV会自动将该字段用双引号包裹避免拆行，属于正常逻辑；如果不需要字段内换行，可提前用gsub("\n", "")清除对应字段的换行内容。
• 若你是将生成的CSV内容用于接口下载，需确认响应头配置正确：需设置Content-Type: text/csv; charset=utf-8，避免浏览器篡改编码导致格式异常。

内容的提问来源于stack exchange，提问作者Arthur Edelman