Excel 与 CSV 导入 API 失败？编码与分隔符的快速排查

安全风信子

发布于 2025-11-18 19:07:56

470

文章被收录于专栏：AI SPPECHAI SPPECH

一句话承诺：用流程与对照表，快速定位导入失败的根因：编码/分隔符/转义。

对照表

项目	典型问题	解决
编码	GBK/UTF-8混用	统一UTF-8，检测BOM
分隔符	逗号/制表符不一致	明确 , 或 \t
引号	字段内含分隔符	使用双引号包裹

命令清单

# 检测编码（Linux）
file -bi data.csv
# 转为UTF-8
iconv -f GBK -t UTF-8 data.csv -o data_utf8.csv

# 检查分隔符（统计逗号数量）
awk -F"," '{print NF}' data_utf8.csv | head

解析示例（Node.js）

const fs = require('fs');
const parse = require('csv-parse');

fs.createReadStream('data_utf8.csv')
  .pipe(parse({
    delimiter: ',',
    columns: true,
    quote: '"',
    escape: '"'
  }))
  .on('data', row => console.log(row))
  .on('error', err => console.error(err));