从ActiveRecord导出Ruby CSV文件，Excel中单引号显示异常

问题背景 #

我用Ruby的CSV库从数据库导出数据生成CSV文件，但用户用Excel打开时总是显示乱码。尝试强制转成US-ASCII编码时，还抛出了这个错误：

Encoding::UndefinedConversionError: U+2019 from UTF-8 to US-ASCII

我的导出代码是这样的：

CSV.open(fileNameInbound, 'wb', :encoding => Encoding::US_ASCII) do |csv| 
  myModel.all.each do |m| 
    csv << m 
  end 
end

用户都是非技术人员，根本不会手动调整文件编码。文件在Sublime Text里显示正常（能看到弯引号这类特殊字符），但Excel打开后这些字符全变成了乱码。

核心原因 #

1. 编码不兼容：错误里的U+2019是弯引号（’），属于UTF-8专属的特殊字符，US-ASCII编码完全不支持，所以强制转换肯定报错。
2. Excel的CSV识别逻辑：Excel默认会用系统本地编码（比如中文Windows是GBK）打开CSV，而我们导出的是UTF-8编码的内容，两者不匹配就会出现乱码。

完美解决方案：导出带BOM的UTF-8 CSV #

给UTF-8格式的CSV文件加上BOM（字节顺序标记），Excel就能自动识别出这是UTF-8编码的文件，不用用户做任何操作，打开直接正常显示。

修改后的代码如下（两种写法任选其一）：

写法1：直接在CSV写入时添加BOM

CSV.open(fileNameInbound, 'wb:UTF-8') do |csv|
  # 先写入UTF-8 BOM标记
  csv << ["\uFEFF"]
  # 遍历模型数据，注意这里要确保m是数组，比如取属性值数组
  myModel.all.each do |m|
    csv << m.attributes.values # 根据你的模型结构调整，确保是列数据数组
  end
end

写法2：通过文件对象先写BOM再写CSV

File.open(fileNameInbound, 'wb') do |f|
  f.write "\uFEFF" # 写入UTF-8 BOM
  # 基于文件对象创建CSV写入器
  CSV(f, encoding: 'UTF-8') do |csv|
    myModel.all.each do |m|
      csv << m.attributes.values
    end
  end
end

注意事项 #

• 如果你之前直接csv << m能运行，可能是模型类实现了to_a方法，但更稳妥的是明确指定要导出的属性数组，避免意外问题。
• 这个方法完全不需要用户干预，完美适配非技术用户的使用场景。

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