UD5工具箱
常见问题
什么是堆栈追踪？
堆栈追踪（Stack Trace）是 JavaScript 运行时环境在代码执行过程中抛出错误时生成的一份调用链路记录。它按照从最近调用到最初触发点的顺序，列出了每一层函数调用的函数名、源文件路径、行号和列号等位置信息。堆栈追踪是调试 JavaScript 错误的核心工具，通过分析堆栈信息可以快速定位错误发生的具体位置和完整的调用路径。在浏览器开发者工具的控制台中，当 JavaScript 代码抛出异常时，错误信息下方会自动显示堆栈追踪。堆栈追踪通常按照从下往上的顺序排列，最上面的一行是错误直接发生的位置，最下面的一行是程序的入口点。
Source Map 的作用是什么？
Source Map（源映射）的主要作用是将压缩、混淆或编译后的代码映射回原始源代码。在现代 Web 开发中，JavaScript 代码在部署到生产环境前通常会经过压缩和混淆处理以减小文件体积，但压缩后的代码可读性极低，直接调试非常困难。Source Map 文件存储了压缩代码和原始代码之间的位置映射关系，让浏览器开发者工具能够在用户调试时显示原始源代码而非压缩代码，包括正确的行号、列号、变量名和函数名等。开发者在构建项目时生成 Source Map 文件，部署时将 Source Map 与压缩代码一同放置在服务器上（但不对外暴露），在需要调试时通过 Source Map 还原准确的错误位置。
不同浏览器的堆栈格式有什么差异？
不同浏览器和 JavaScript 引擎生成的堆栈追踪格式存在显著差异。Chrome 使用 V8 引擎，堆栈格式为 "at 函数名 (文件:行:列)"，结构清晰且包含列号信息。Firefox 使用 SpiderMonkey 引擎，格式为 "函数名@文件:行:列"，使用 @ 符号作为分隔符，更加紧凑。Safari 使用 JavaScriptCore 引擎，格式与 Firefox 类似但通常不包含列号信息，格式为 "函数名@文件:行"。Node.js 基于 V8 引擎，堆栈格式与 Chrome 类似，但在处理 CommonJS 模块和 ESM 模块的文件路径表示上有所不同。本工具能够自动识别这四种格式并进行正确解析，用户无需手动选择堆栈格式类型。
VLQ 编码的原理是什么？
VLQ（Variable Length Quantity）是一种可变长度的整数编码方式，用于高效地表示不同大小的整数值。VLQ 编码的核心原理是：每个字节的最高位（第7位，从0开始计数）用作延续标志位，值为1表示后面还有更多字节，值为0表示这是最后一个字节。每个字节的低6位存储实际的数据部分。解码时，将所有字节的低6位按顺序拼接，即可得到原始的整数值。在 Source Map 中，VLQ 编码的结果还会经过 Base64 编码转换为可打印字符。例如，Base64-VLQ 字符 "C" 对应二进制 000010，最高位为0（最后一个字节），低6位为2，解码结果为2。字符 "I" 对应二进制 001000，最高位为0，低6位为8，解码结果为8。通过这种编码方式，Source Map 可以用紧凑的文本形式存储大量的行列号偏移数据。
使用 Source Map 有什么安全注意事项？
使用 Source Map 时需要注意以下安全事项：(1) 不要将 Source Map 文件公开部署在生产环境的服务器上，否则任何人都可以通过 Source Map 还原您的原始源代码，暴露代码逻辑和业务实现细节；(2) 在 Source Map 文件中可以包含 sourcesContent 字段，该字段包含完整的原始源代码内容，如果 Source Map 被泄露，源代码也会随之暴露；(3) 如果必须在生产环境调试，建议将 Source Map 部署在需要身份验证的内部服务器上，仅允许授权的开发人员访问；(4) 可以在 Source Map 文件中故意省略或模糊化部分敏感文件的映射信息；(5) 定期清理不再需要的 Source Map 文件，减少数据泄露的风险。正确的做法是在构建时生成 Source Map，部署时将其保存在安全的内部位置，仅在调试时按需使用。
为什么压缩代码需要 Source Map？
压缩代码需要 Source Map 的根本原因是压缩过程会破坏代码的可读性和可调试性。代码压缩工具在减小文件体积的过程中会执行以下操作：移除所有空格、换行和注释，缩短变量名和函数名为单字符标识符，合并相邻的语句，移除未使用的代码等。这些操作导致压缩后的代码与原始代码在行号、列号和标识符名称上完全不同。当压缩代码在运行时抛出错误时，堆栈追踪中的位置信息对应的是压缩后的代码位置，开发者无法直接根据这些信息在原始源代码中找到错误位置。Source Map 存储了压缩代码位置和原始代码位置之间的精确映射关系，让调试工具能够将压缩代码的堆栈信息转换为原始代码的位置，使开发者可以直接在原始源代码中定位和修复错误。没有 Source Map，开发者只能面对压缩后的一行代码进行猜测式的调试，效率极低且容易出错。