css 解析后对象的键名常因首行表头存在隐藏空格（如 `'bookmaker'` 实际为 `' bookmaker'`）而无法通过 `data.bookmaker` 正常访问，需统一清洗键名并使用方括号语法安全读取。
在使用 csv-parser 处理分号分隔的 CSV 文件时，库默认将第一行作为列头（headers），并据此生成每行数据的对象。但若原始 CSV 表头包含不可见的前导或尾随空格（例如 ";Sport;Categorie" 导致首列为 " Bookmaker" 而非 "Bookmaker"），则生成的对象键名会携带这些空白字符——这正是 data.Bookmaker 返回 undefined、且 data['Bookmaker'] 也失效的根本原因：键名实际为 ' Bookmaker' 或 'Bookmaker '。
✅ 正确做法是在解析完成后统一标准化所有键名，而非逐个硬编码带空格的键。推荐在 'end' 事件中对首行数据的键进行 trim() 处理，并重建映射关系：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
const fs = require('fs');
const csv = require('csv-parser');
const dataRows = [];
const filePath = './bets.csv';
fs.createReadStream(filePath)
.pipe(csv({ separator: ';', headers: true })) // 显式启用 headers 更可控
.on('data', (row) => {
dataRows.push(row);
})
.on('end', () => {
if (dataRows.length === 0) return;
// 1. 获取首行原始键名并清洗（去空格）
const rawKeys = Object.keys(dataRows[0]);
const cleanKeys = rawKeys.map(key => key.trim());
// 2. 构建原始键 → 清洗键的映射表（保留原始结构兼容性）
const keyMap = {};
rawKeys.forEach((raw, i) => {
keyMap[raw] = cleanKeys[i];
});
// 3. 批量重写每行数据：用清洗后的键替换原始键
const normalizedRows = dataRows.map(row => {
const normalized = {};
Object.entries(row).forEach(([rawKey, value]) => {
const cleanKey = keyMap[rawKey] || rawKey.trim();
normalized[cleanKey] = value;
});
return normalized;
});
// ✅ 现在可安全使用点语法或标准方括号访问
normalizedRows.forEach(row => {
console.log('Bookmaker:', row.Bookmaker); // ✅ 成功输出
console.log('Sport:', row.Sport);
console.log('Gain:', row.Gain);
});
});⚠️ 注意事项：
- 不要依赖 headers: false + 手动跳过首行：虽可规避表头解析，但需自行解析首行并映射，易出错且丧失 csv-parser 的类型推断优势；
- 避免仅对单个字段 trim()：如 data['Bookmaker'.trim()] 仍失败，因实际键名并非 'Bookmaker'；
- 生产环境建议添加键名校验：解析后检查 cleanKeys.includes('Bookmaker')，缺失时抛出明确错误，便于定位 CSV 格式问题；
- 若 CSV 含 BOM（如 UTF-8 with BOM），可能引入 \uFEFF 前缀，此时需额外 key.replace(/^\uFEFF/, '').trim()。
总结：CSV 字段名的“不可访问”本质是字符串匹配失败，核心解法是标准化键名——通过批量清洗与映射，将脏数据转化为语义清晰、可稳定访问的对象结构，既保障健壮性，又维持代码可读性。
