使用fast-csv/papaparse解析CSV存入全局变量获空数组如何解决

CSV文件读取和解析是异步IO操作，代码执行时会先跑完所有同步逻辑（也就是你写在全局的console.log(states)），此时data事件还未触发，states数组还没被推入数据，所以拿到的是空数组。所有依赖解析结果的逻辑，必须等待异步操作完成后才能执行，无法在全局作用域同步拿到异步返回的结果。

方案1：Promise封装 + async/await调用（兼容性最好） #

将CSV解析逻辑封装为返回Promise的函数，所有使用states的逻辑都放在await后的代码块中：

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

// 封装CSV解析逻辑，返回指定列的数组
function getCsvColumn(filePath, columnIndex = 2) {
  return new Promise((resolve, reject) => {
    const result = [];
    fs.createReadStream(filePath)
      .pipe(csv.parse({ headers: false }))
      .on('data', row => result.push(row[columnIndex]))
      .on('end', () => resolve(result))
      .on('error', err => reject(err)); // 必须添加错误处理
  });
}

// 用async自执行函数调用
(async () => {
  try {
    const states = await getCsvColumn('main.csv');
    // 所有依赖states的逻辑都写在这里
    console.log(states);
    // 可以把业务逻辑封装为函数调用
    yourBusinessLogic(states);
  } catch (err) {
    console.error('解析CSV失败：', err);
  }
})();

function yourBusinessLogic(states) {
  // 在这里编写你的业务逻辑
  console.log(`共读取到${states.length}条数据`);
}

方案2：顶层await（Node.js 14.8+支持） #

如果你的项目使用ES模块规范（文件后缀为.mjs，或package.json中设置"type": "module"），可以直接使用顶层await，无需包裹自执行函数：

import fs from 'fs';
import csv from 'fast-csv';

async function getCsvColumn(filePath, columnIndex = 2) {
  return new Promise((resolve, reject) => {
    const result = [];
    fs.createReadStream(filePath)
      .pipe(csv.parse({ headers: false }))
      .on('data', row => result.push(row[columnIndex]))
      .on('end', () => resolve(result))
      .on('error', err => reject(err));
  });
}

// 顶层await，后续代码会等待解析完成后执行
const states = await getCsvColumn('main.csv');
console.log(states);
// 后续业务逻辑直接写在这里即可

不要尝试将异步结果赋值给全局变量后同步调用，哪怕你等待几秒再访问也不推荐，这种写法不可靠且不符合JS事件循环的执行规则。所有依赖异步结果的逻辑，都应该放在异步完成后的回调、await后代码块中执行。

内容的提问来源于stack exchange，提问作者Nitish