JavaScript作用域问题：Node.js fs中全局变量push后未生效，求解答

Hey there! Let's break down why your global array isn't updating after calling push() when working with Node.js's fs module—this is a super common gotcha, so don't worry, you're not alone in hitting this.

最可能的原因：异步代码执行顺序问题 #

The fs module's most commonly used methods (like readFile, readdir) are asynchronous—they don't block the rest of your code from running while they do their work. That means if you try to access your global variable right after calling an async fs method, the push() operation in the callback hasn't actually happened yet.

错误示例 #

let globalArray = [];

// 异步读取文件，回调函数会在文件读取完成后才执行
fs.readFile('example.txt', 'utf8', (err, content) => {
  if (err) throw err;
  globalArray.push(content); // 这行代码执行时机晚于下面的console.log
});

console.log(globalArray); // 输出 []，因为回调还没触发！

解决方案 #

There are a few ways to fix this depending on your use case:

1. 使用同步方法（适合简单场景）

If blocking the event loop isn't a problem (like in small scripts), you can use the synchronous versions of fs methods (ending with Sync). These will wait for the operation to finish before moving on:

let globalArray = [];

try {
  const content = fs.readFileSync('example.txt', 'utf8');
  globalArray.push(content);
  console.log(globalArray); // 正确输出更新后的数组
} catch (err) {
  console.error('读取文件出错:', err);
}

2. 在回调内处理后续逻辑（推荐异步场景）

Keep all code that depends on the updated global variable inside the async callback, so it only runs after the push() has happened:

let globalArray = [];

fs.readFile('example.txt', 'utf8', (err, content) => {
  if (err) {
    console.error('读取文件出错:', err);
    return;
  }
  globalArray.push(content);
  // 所有需要用到globalArray的操作都放在这里
  console.log(globalArray); // 正确输出
  processArray(globalArray);
});

function processArray(arr) {
  // 在这里处理更新后的数组
}

3. 使用Promise + Async/Await（更优雅的异步处理）

Modern Node.js lets you use promise-based fs methods (via fs.promises) with async/await, which makes asynchronous code read more like synchronous code:

const fs = require('fs').promises;
let globalArray = [];

async function loadFileContent() {
  try {
    const content = await fs.readFile('example.txt', 'utf8');
    globalArray.push(content);
    console.log(globalArray); // 正确输出
  } catch (err) {
    console.error('读取文件出错:', err);
  }
}

loadFileContent();

另一个可能原因：变量遮蔽 #

If you're still having issues, check if you're redeclaring the same variable name inside your function with let or var. This creates a local variable that shadows the global one—so you're pushing to the local array instead of the global one:

错误示例 #

let globalArray = [];

function loadData() {
  let globalArray = []; // 这里重新声明了局部变量，和全局的不是同一个！
  fs.readFile('example.txt', (err, content) => {
    globalArray.push(content); // 修改的是局部数组，全局数组毫无变化
  });
}

解决方案 #

Remove the local variable declaration so you're referencing the global one:

let globalArray = [];

function loadData() {
  // 去掉这里的let globalArray = []
  fs.readFile('example.txt', (err, content) => {
    if (err) throw err;
    globalArray.push(content); // 现在修改的是全局数组了
  });
}

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