CSV 解析中首列键名含不可见空格导致属性访问失败的解决方案

csv 解析后对象的首列键名常因 excel 或编辑器导出问题携带隐藏空格，导致 `data.bookmaker` 访问失败；正确做法是统一清洗键名（如 `.trim()`），再通过规范化的键名使用方括号语法安全取值。

在使用 csv-parser 处理 CSV 文件时，若第一行为表头（默认行为），解析器会将该行每一项作为对象的键名生成结果。但常见问题在于：Excel、Numbers 或某些文本编辑器导出的 CSV 中，首列标题（如 "Bookmaker"）前后可能含有不可见空格（例如 ' Bookmaker' 或 'Bookmaker '），导致 data.Bookmaker 返回 undefined —— 因为实际键名为带空格的字符串，而点号语法（dot notation）仅支

持合法标识符名称，无法匹配含空格或特殊字符的键。

✅ 正确做法是：始终优先使用方括号语法 + 键名标准化。以下是一个健壮、可复用的处理流程：

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

const dataRows = [];
const filePath = './data.csv';

fs.createReadStream(filePath)
  .pipe(csv({ separator: ';' }))
  .on('data', (row) => {
    // 第一次接收数据时，标准化所有键名（去首尾空格）
    if (dataRows.length === 0) {
      const cleanKeys = Object.keys(row).map(key => key.trim());
      const cleanRow = {};
      cleanKeys.forEach((cleanKey, i) => {
        const originalKey = Object.keys(row)[i];
        cleanRow[cleanKey] = row[originalKey];
      });
      dataRows.push(cleanRow);
    } else {
      // 后续行沿用相同键名结构，直接清洗并映射
      const cleanRow = {};
      Object.keys(row).forEach(key => {
        cleanRow[key.trim()] = row[key];
      });
      dataRows.push(cleanRow);
    }
  })
  .on('end', () => {
    // ✅ 现在可安全访问：无论原始 CSV 是否含空格，键名均已标准化
    dataRows.forEach((data, index) => {
      console.log(`Row ${index + 1} Bookmaker:`, data['Bookmaker'] || 'N/A');
      console.log(`Sport:`, data['Sport'] || 'N/A');
      // 其他字段同理...
    });

    // ? 进阶建议：提取唯一键名集合并验证结构一致性
    const allKeys = [...new Set(dataRows.flatMap(obj => Object.keys(obj)))].sort();
    console.log('Normalized headers:', allKeys);
  });

? 关键注意事项：

• 不要依赖 data.Bookmaker —— 点号语法对非标准键名（含空格、连字符、中文、数字开头等）完全失效；
• 始终使用 data['Bookmaker'] 或 data[bookmakerKey] 形式，并确保 bookmakerKey 已清洗（.trim()）；
• 若需兼容多语言或复杂表头，可进一步使用正则替换非法字符（如 key.replace(/[^a-zA-Z0-9_]/g, '_')），但需注意与业务字段语义对齐；
• 在写入 MongoDB 前，建议对所有键名执行统一清洗，避免后续查询或索引异常；
• 开发阶段可在 console.log(Object.keys(data)) 后加 .map(k => JSON.stringify(k)) 显式查看键名真实内容（含空格/制表符等）。

通过主动清洗键名并坚持使用方括号访问，即可彻底规避 CSV 表头格式不一致带来的属性访问陷阱，提升数据管道的健壮性与可维护性。