Ruby on Rails导出CSV在Android版Google Sheets中字符异常修复咨询

DevOps 小满

2026-5-26

修复Android版Google Sheets中CSV特殊字符缺失的问题

这个问题我之前也碰到过，Android版的Google Sheets对UTF-8编码的CSV文件识别确实有点“挑剔”，尤其是带特殊字符（比如你表头里的撇号’）的时候。主要原因是它不像桌面端那样能自动识别无BOM的UTF-8文件，导致特殊字符解析出错。下面是几个可行的修复方案：

添加UTF-8字节顺序标记（BOM）
很多移动端表格工具需要BOM来明确识别UTF-8编码，你可以在写入CSV内容前先写入BOM字符。修改你的导出代码如下：

File.open(file_name, 'wb') do |file|
  # 写入UTF-8 BOM，让Android Sheets正确识别编码
  file.write("\xEF\xBB\xBF")
  CSV.new(file, encoding: 'utf-8') do |csv|
    csv << column_names
    csv << data
  end
end

强制为所有字段添加引号
有时候特殊字符会被Sheets误解析为字段分隔符的一部分，强制给所有字段加引号可以避免这个问题。结合BOM的话，代码可以改成这样：
```
File.open(file_name, 'wb') do |file|
  file.write("\xEF\xBB\xBF")
  CSV.new(file, encoding: 'utf-8', force_quotes: true) do |csv|
    csv << column_names
    csv << data
  end
end
```
确认数据源编码
另外要确保你的column_names和data本身是UTF-8编码的，Rails项目里如果数据库用的是utf8mb4编码（推荐），一般不会有问题，但如果是旧的utf8编码，可能会丢失部分特殊字符，这时候需要调整数据库编码。