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 表头格式不一致带来的属性访问陷阱，提升数据管道的健壮性与可维护性。
