JavaScript / TypeScript / 系统课时

定位常见 JavaScript 错误

定位常见 JavaScript 错误

本篇帮助你建立 JavaScript 错误定位方法,理解不同错误类型产生的原因,并通过浏览器开发者工具和代码分析快速找到问题位置。

学习目标

  • 识别 SyntaxError、ReferenceError、TypeError 等常见运行错误。
  • 掌握从错误信息、堆栈和代码上下文定位问题的方法。
  • 区分程序执行失败与结果错误两类问题。

理解 JavaScript 错误分类

JavaScript 错误通常分为语法错误、运行时错误和逻辑错误。不同类型的错误表现不同,定位方式也不同。

错误类型 产生时机 常见原因
SyntaxError 代码解析阶段 括号缺失、关键字错误、语法不合法
ReferenceError 执行阶段 使用不存在的变量或函数
TypeError 执行阶段 对错误类型的数据调用方法
逻辑错误 程序正常运行后 条件判断、计算过程或业务规则错误

理解错误类别可以帮助你快速缩小排查范围,而不是只盯着报错位置修改代码。

根据错误信息定位问题

浏览器控制台通常会提供错误名称、错误消息和代码位置。例如下面代码会触发 ReferenceError:

js
function printUser() {
  console.log(userName);
}

printUser();

预期输出

text
ReferenceError: userName is not defined

错误信息已经指出变量不存在,排查重点应该放在变量声明、作用域和拼写上,而不是怀疑函数调用本身。

当错误包含文件名和行号时,应优先查看对应代码位置,再向上检查变量来源和调用链。

使用堆栈分析调用过程

运行时错误通常会包含调用堆栈。堆栈表示函数之间的调用路径,可以帮助定位错误从哪里产生。

例如:

js
function getLength(value) {
  return value.length;
}

function showName(name) {
  return getLength(name);
}

showName(null);

预期输出

text
TypeError: Cannot read properties of null (reading 'length')

这里真正的问题不是 length 属性,而是传入的参数为 null。排查时需要沿调用链向上寻找错误数据的来源。

排查逻辑错误

逻辑错误不会让程序崩溃,而是产生错误结果。例如计算折扣金额时,代码可能可以执行,但业务结果错误。

js
function calculatePrice(price, discount) {
  return price * discount;
}

console.log(calculatePrice(100, 20));

预期输出

text
2000

如果业务要求折扣百分比,这个结果就是错误的。逻辑错误定位通常依赖:

  • 检查输入数据是否符合预期。
  • 使用断点观察变量变化。
  • 对关键函数增加测试用例。

建立稳定的排错流程

遇到 JavaScript 错误时,可以按照以下顺序处理:

  1. 阅读错误类型,判断属于语法、运行时还是逻辑问题。
  2. 查看错误位置,确认首次异常发生的位置。
  3. 检查相关变量、参数和函数调用关系。
  4. 使用最小输入复现问题。
  5. 修复后重新验证相关场景。

熟练掌握错误分类和定位流程,比记忆大量错误信息更重要。实际开发中,错误提示提供的是线索,真正的问题通常隐藏在错误发生之前的数据流和调用关系中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位常见 JavaScript 错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通