JavaScript 初学者常见错误大全：从 A 到 Z

引言：为什么 JavaScript 对初学者来说是个雷区？

JavaScript 是一门既容易上手又难以深入理解的语言。许多新手开发者在接触 Node.js 时，会遇到看似不合理的意外错误。问题往往不在于算法的逻辑，而在于语言本身的特性：异步性、this 的非直观行为以及作用域的微妙之处。

在本文中，我们将分析初学者在 JavaScript（以 Node.js 为例）中最常犯的错误。每个要点都会附上实际代码和 如何修复 的说明。如果你想编写可靠的代码并避免花费数小时调试，这篇文章就是为你准备的。

1. 作用域混淆：var、let 和 const

最常见的问题之一是使用过时的 var，并且不理解 let 和 const 之间的区别。

var 与变量提升的问题

用 var 声明的变量会被“提升”到函数的顶部，但在初始化之前保持 undefined。这会导致难以发现的错误。

// ❌ 错误：打印 undefined 而不是 ReferenceErrorconsole.log(myVar); // undefined（没有报错！）var myVar = 5;

// ✅ 正确：使用 let 或 constconsole.log(myLet); // ReferenceError：初始化前无法访问 'myLet'let myLet = 5;

循环中的闭包

在循环中使用 var 的经典错误：

// ❌ 错误：所有回调都会输出 3for (var i = 0; i < 3; i++) {    setTimeout(() => console.log(i), 100);}// 输出：3, 3, 3

// ✅ 修复：let 为每次迭代创建新的绑定for (let i = 0; i < 3; i++) {    setTimeout(() => console.log(i), 100);}// 输出：0, 1, 2

提示： 在现代 JavaScript 中忘记 var。默认使用 const，如果变量需要重新赋值则使用 let。

2. 异步地狱：回调地狱与错误的 Promise 处理

Node.js 基于异步机制。初学者常常试图同步地获取异步函数的结果，导致得到 undefined。

忽略 Promise

// ❌ 错误：函数返回 undefinedfunction getUserData(userId) {    const user = database.findUser(userId); // 异步操作    return user; // undefined，因为数据尚未到达}

// ✅ 正确：返回一个 promiseasync function getUserData(userId) {    const user = await database.findUser(userId);    return user;}

回调地狱

嵌套的回调使代码难以阅读和维护：

// ❌ 糟糕：回调金字塔fs.readFile('a.txt', (err, dataA) => {    fs.readFile('b.txt', (err, dataB) => {        fs.writeFile('c.txt', dataA + dataB, (err) => {            console.log('完成！');        });    });});

// ✅ 良好：async/awaitasync function mergeFiles() {    const dataA = await fs.promises.readFile('a.txt');    const dataB = await fs.promises.readFile('b.txt');    await fs.promises.writeFile('c.txt', dataA + dataB);    console.log('完成！');}

黄金法则： 如果你看到嵌套超过两层，请使用 async/await 进行重构。

3. 神秘的 this：上下文丢失

在 JavaScript 中，this 由函数的 调用方式 决定，而不是 声明位置。这是造成混淆的主要原因。

对象方法中丢失 this

const user = {    name: 'Alex',    greet() {        console.log(`你好，${this.name}`);    }};

// ✅ 正常工作user.greet(); // 你好，Alex

// ❌ 错误：this 丢失