UD5工具箱
术语表
以下是与错误堆栈追踪解析和 Source Map 相关的专业术语解释，帮助您更好地理解工具中涉及的概念和技术细节。
堆栈追踪（Stack Trace）
堆栈追踪是在 JavaScript 代码执行过程中抛出错误时，由运行时环境生成的一份调用链路记录。它按照函数调用的先后顺序（从最近的调用到最初的触发点），列出了每一层函数调用的函数名、源文件路径、行号和列号等位置信息。堆栈追踪是调试 JavaScript 错误的最重要工具，通过分析堆栈信息可以快速定位错误发生的具体位置和调用路径。不同的浏览器和运行环境生成的堆栈格式有所差异，但核心信息是相同的。
Source Map（源映射）
Source Map 是一种将压缩、混淆或编译后的代码映射回原始源代码的技术规范。Source Map 文件（通常以 .map 为扩展名）包含了原始代码和压缩代码之间的位置映射关系。通过 Source Map，开发者可以在浏览器开发者工具中直接查看和调试原始源代码，即使实际加载的是压缩后的代码。Source Map 文件遵循 Mozilla 定义的标准格式，包含版本号、源文件列表、名称列表和映射数据等字段。现代前端构建工具在压缩代码时都会默认生成 Source Map 文件。
VLQ（Variable Length Quantity）
可变长度数量编码，是一种用于高效编码整数的二进制压缩方法。在 Source Map 中，VLQ 编码用于存储映射数据中的行列号偏移量等整数值。VLQ 编码的核心原理是使用每个字节的最高位（MSB）作为延续标志位：值为1表示后面还有更多字节，值为0表示这是最后一个字节。每个字节的剩余7位存储实际的数据。通过这种编码方式，较小的整数（如1到15）只需1个字节即可表示，而较大的整数也只需少量字节。Source Map 中使用的是 Base64-VLQ 编码，将 VLQ 编码的结果再转换为 Base64 字符序列存储在 mappings 字段中。
Base64 编码
Base64 是一种将二进制数据编码为 ASCII 文本字符的编码方式。它使用 A-Z、a-z、0-9、+ 和 / 共64个可打印字符来表示数据。在 Source Map 的映射数据中，VLQ 编码后的整数值会通过 Base64 编码转换为单个字符，使得映射数据可以安全地存储在 JSON 格式的文件中。Source Map 使用的是标准的 Base64 编码表，其中字符 A 的值为0，B 的值为1，依此类推，直到字符 a 的值为26、z 的值为51。这种编码方式使得 Source Map 的 mappings 字段虽然包含大量数据，但仍然是纯文本格式。
压缩代码（Minified Code）
压缩代码是指经过代码压缩工具处理后的 JavaScript 代码，通过移除空格、换行、注释等非必要字符，以及缩短变量名和函数名等方式来减小文件体积。常见的 JavaScript 压缩工具包括 Terser（Webpack 默认）、UglifyJS、esbuild 和 SWC 等。压缩后的代码体积通常可以减少50%到80%，显著提升网页的加载速度。但压缩代码的可读性极低，变量名被替换为短小的标识符，行号和列号与原始代码完全不同，这使得在压缩代码上调试错误变得非常困难，需要依赖 Source Map 来还原原始位置。
混淆（Obfuscation）
代码混淆是指在代码压缩的基础上，进一步对代码进行可读性破坏处理的技术。混淆工具（如 javascript-obfuscator）会将变量名、函数名替换为无意义的短标识符或十六进制编码，插入死代码和控制流平坦化代码，转换字符串为特殊的编码形式等。混淆的目的是防止代码被轻易逆向分析和理解，常用于保护商业逻辑和知识产权。混淆后的代码调试难度比普通压缩代码更高，更依赖 Source Map 来进行错误追踪和调试。
Chrome/V8 堆栈格式
Chrome 浏览器和 Node.js（使用 V8 引擎）生成的堆栈追踪格式。每一行以 "at" 关键字开头，后面跟随函数名和位置信息，格式为 "at 函数名 (文件路径:行号:列号)"。如果函数是全局执行的，则函数名显示为 "Object." 或省略。如果位置信息不可用，则显示为 "native" 或 "unknown"。V8 堆栈格式是目前最广泛使用的堆栈格式，也是本工具支持最完善的格式。
Firefox/SpiderMonkey 堆栈格式
Firefox 浏览器（使用 SpiderMonkey 引擎）生成的堆栈追踪格式。每一行使用 "@" 符号作为分隔符，格式为 "函数名@文件路径:行号:列号"。与 Chrome 格式相比，Firefox 格式更加紧凑，没有括号包裹位置信息。SpiderMonkey 引擎还支持显示更详细的内部函数名，包括闭包函数和箭头函数的名称信息。
Safari/JavaScriptCore 堆栈格式
Safari 浏览器（使用 JavaScriptCore 引擎）生成的堆栈追踪格式。格式与 Firefox 类似，使用 "@" 符号分隔函数名和位置信息，格式为 "函数名@文件路径:行号"。与 Firefox 格式不同的是，Safari 格式通常不包含列号信息。JavaScriptCore 引擎在某些版本中还会添加额外的上下文信息，如匿名函数的标记方式与 Chrome 和 Firefox 有所不同。