团队规范：VS Code调试，实测有效

▌ 技术引导
VS Code调试直接上配置，不玩虚的。用过的人知道，它不是个普通编辑器，是干活的工具。调试的时候直接开终端，不要傻乎乎地用浏览器调试。设置断点可以用`debugger`或者`console.log`，但后者效率低，尤其在大数据量的时候会卡。调试器本身支持多语言，JavaScript、TypeScript、Python、C++都行。我见过有人因为没设置`launch.json`，导致每次调试都要重新配置，浪费时间。关键是要记住`--inspect`参数，这个参数是调试的命根子。还有个细节，调试的时候不要用`node app.js`，要用`node --inspect app.js`，这样能捕获更多上下文信息。这些经验都是实打实的，不是网上抄的。

调试器加载代码时，如果没加`--no-warmup`参数，会慢得离谱。尤其在用`debug`模块的时候，这种问题会直接暴露。我之前在Windows上调试Node.js，发现源码映射总是不对，后来才发现是`sourceMap`配置没搞对，导致调试器看到的代码和实际文件不一致。解决办法是手动指定`sourceMap`路径，或者用`--inspect`加`--no-source-maps`直接禁用。还有一件事情，调试多线程应用的时候，不要忘了加`--enable-source-maps`，这样多线程的堆栈信息才能正常显示。这些细节点都是在实际项目中踩出来的，别以为是小事。

VS Code调试的性能优化，关键在内存和加载策略。我的一个项目用`node-inspector`调试，结果内存占用爆表，后来换成VS Code自带的调试器，内存占用直接降了30%。还有个经验，调试的时候不要把所有模块都加载进来，特别是第三方库，可以用`--experimental-loader`指定只加载必要的模块。另外，我见过有人用`sourceMap`导致调试器卡顿，所以可以考虑在生产环境关闭`sourceMap`，或者用`--no-source-maps`参数。还有个现实问题，调试有时候会因为代码结构复杂，导致堆栈跟踪丢失，这时候就要用`--inspect-brk`参数，在入口函数前打断点，确保调试器能正确进入堆栈。

在Windows上调试Node.js有一个陷阱，就是默认不支持多端口调试，如果多个实例同时运行，只能调试其中一个。解决办法是用`--inspect=9229`手动指定端口，或者在`launch.json`里用`debuggerPort`配置。还有人问过为什么调试的时候看不到某些变量，其实是因为调试器默认只显示可序列化的变量，所以数据类型复杂的变量会消失。这时候要改`console.log`，或者在代码里加`debugger`并用`Object.keys()`打印变量名。另外，调试的时候如果代码有热更新，建议用`--inspect`加`--no-repl`参数，这样不会触发自动重启，节省时间。

VS Code调试的配置文件`launch.json`可以写多个配置项，不同项目用不同配置。比如一个项目用`node --inspect`，另一个用`electron --inspect`。我之前在调试Electron的时候，发现默认的调试器不支持多进程，后来手动加了`runtimeExecutable`参数，指定`electron`路径，解决了问题。还有一个情况，调试的时候如果出现`Cannot find module`的错误，可能是调试器没加载源文件，这时候要检查`sourceMaps`是否正确配置，或者在`launch.json`里加`sourceMapPathRewriting`。还有人用`--trace-deprecation`参数来调试内存泄漏问题，这个参数能打印所有被弃用的API调用，有助于排查问题。

▌ 技术参考
一 VS Code调试的默认配置是`node --inspect`，但实际使用中发现它无法支持某些模块的堆栈跟踪。特别是用`async/await`或`Promise`的时候，如果未指定`--inspect`参数，调试器会跳过部分代码，导致调试不准确。解决方法是直接在启动命令中加`--inspect`，或者通过`launch.json`设置`runtimeExecutable`为`node --inspect`。此外，还可以用`--inspect-brk`在入口函数前打断点，确保调试器能正确进入堆栈。这个配置在Windows和Linux上表现不同，windows需要额外加`--no-warmup`避免卡顿。

二 在配置`launch.json`时，一定要注意`type`字段，它决定了调试器的类型。例如`node`、`chrome`、`electron`等类型对应不同的调试方式。如果使用`electron`类型，必须指定`runtimeExecutable`为`electron`的绝对路径，否则调试器会找不到入口。另外，`runtimeArgs`可以添加额外参数，比如`--inspect=9229`或`--no-source-maps`。在调试Electron应用时，还可以用`webRoot`指定前端代码的路径，避免调试器找不到源文件。这些配置在Windows和Linux上都需要手动调整，不能照搬。

三 调试器在加载模块时，如果遇到`Cannot find module`错误，通常是因为调试器没有正确解析模块路径。这时候需要检查`sourceMap`或`sourceMaps`配置是否正确。如果使用`--experimental-modules`运行环境，调试器可能无法加载ES模块，除非手动指定`sourceMap`路径。还可以用`--no-source-maps`参数直接禁用源映射，避免调试器加载不必要的文件。此外，调试器默认不支持`import`语句，需要用`--experimental-loader`指定加载器，或者在`launch.json`里配置`sourceMapPathRewriting`。

四 在调试多线程应用时，VS Code自带调试器支持多进程调试，但需要明确指定监听端口。例如，用`--inspect=9229`启动主进程，用`--inspect=9230`启动工作线程，这样调试器才能分别捕获不同线程的信息。此外，调试器默认不支持多实例同时调试，如果需要同时调试多个实例，需要手动配置`debuggerPort`，并确保每个实例使用不同的端口。如果遇到线程之间的堆栈信息丢失问题，可以用`--trace-deprecation`参数查看是否有被弃用的API调用，或者在代码中使用`debugger`手动打断点。

五 调试器在处理大型项目时，加载速度会变慢，尤其是在Windows系统上。这时候可以使用`--no-warmup`参数，避免调试器预加载不必要的模块。还可以用`--inspect`加`--no-source-maps`来关闭源映射，提高加载速度。如果调试器卡顿严重，可以考虑在`launch.json`里配置`sourceMap`路径，或者用`--source-maps`参数手动指定。另外，调试器加载时间还和代码结构有关，如果代码中有大量`import`或`require`，建议用`--experimental-loader`指定更高效的加载器，例如`--experimental-loader=esm`。

六 在调试时如果遇到`Uncaught ReferenceError`，通常是因为调试器没有加载完整的源码。这时候需要检查`sourceMaps`是否正确配置，或者在代码中加`console.log`代替`debugger`，避免调试器跳过部分代码。如果调试器仍然无法加载源码，可以尝试在`launch.json`里用`sourceMapPathRewriting`手动重写路径，例如将`./dist`映射到`./src`。此外，某些模块加载器可能不支持调试，这时候要用`--experimental-modules`参数启用ES模块调试，或者手动替换模块加载方式。

七 调试器加载性能还可以通过`--inspect`参数控制，比如加`--inspect=9229`可以指定监听端口，避免端口冲突。如果调试器在启动时卡在`Debugger attached`，可能是因为进程启动速度太慢，可以加`--no-warmup`加快启动。对于小型项目，`--inspect`和`--no-source-maps`的结合能显著提升调试效率。如果调试器需要访问远程服务器，可以在`launch.json`里配置`runtimeExecutable`为`node`的远程调试版本，例如`node --inspect=9229`。

八 某些第三方库在调试时会报错`Module version mismatch`，这时候需要检查`node_modules`是否被正确加载。可以在`launch.json`里加`cwd`参数指定工作目录，确保调试器能正确找到模块。如果模块是通过`npm install`安装的，但调试器找不到，可能是路径配置错误，需要手动指定`sourceMap`。此外，如果调试器加载的模块版本和本地不一致，可能需要在代码中加`console.log`来手动输出模块路径，或者用`--inspect`加`--no-warmup`强制重新加载。

九 在调试时如果出现`Cannot read property`的错误，通常是因为调试器无法解析某些变量。这时候需要在代码中用`console.log`输出变量值，或者在`launch.json`里加`sourceMap`配置，确保调试器能正确映射变量。如果变量是对象或者数组，调试器可能显示`undefined`，这时候可以加`--inspect`参数并用`--trace-deprecation`查看是否有被弃用的API影响变量解析。还可以用`--experimental-modules`启用ES模块调试，避免某些模块被错误解析。

十 调试器支持多种语言，但配置时要根据语言类型调整参数。例如调试Python时，用`--inspect`参数无法直接生效，需要在`launch.json`里配置`type`为`python`，并添加`console`选项指定输出方式。调试C++时，需要在`launch.json`里设置`runtimeExecutable`为`gdb`或`lldb`，并用`runtimeArgs`指定程序路径和参数。如果遇到`Debugger not attached`的错误，可能是调试器客户端和服务器端版本不一致，需要手动指定`--inspect`端口和`--inspect-brk`参数。

十一 如果调试器在启动时提示`Break on startup`，可以用`--inspect-brk`参数打断点，确保调试器能正确加载代码。这个参数在调试Node.js时特别有用，尤其是在调试入口文件时，能避免代码跳过。如果调试器加载完成后卡在`Debugger attached`，可以尝试用`--inspect`加`--no-source-maps`避免加载不必要的源码。此外，如果调试器无法识别某些函数，可能是模块加载方式问题，需要用`--experimental-loader`指定正确的加载器。

十二 调试器加载时如果遇到`Error loading source map`，检查`sourceMap`路径是否正确，或者在`launch.json`里用`sourceMap`参数指定路径。如果路径不对，会经常出现这个问题，导致调试器显示错误信息。还可以用`--no-source-maps`参数直接关闭源码映射，避免调试器卡在加载阶段。在调试多模块项目时，`sourceMap`配置尤为重要，需要手动指定每个模块的路径。如果调试器仍然无法加载，可以尝试用`--experimental-modules`启用ES模块支持。

十三 某些调试器默认不支持热更新，导致每次修改代码后需要重启。这时候可以加`--inspect`参数并用`--no-repl`禁用交互式调试，避免不必要的重启。如果调试器在热更新时卡顿，可以考虑在`launch.json`里配置`sourceMap`路径，或者用`--experimental-loader`指定更高效的加载器。此外，调试器加载时间还和代码体积有关，如果代码太大，建议用`--no-source-maps`减少加载时间。

十四 在Windows上调试Electron时，调试器默认不支持多实例调试，需要手动配置`debuggerPort`并确保每个实例使用不同的端口。例如主进程用`--inspect=9229`，渲染进程用`--inspect=9230`，这样调试器才能分别追踪不同模块。如果遇到调试器加载失败，可能是`node_modules`路径不对，需要在`launch.json`里用`cwd`参数指定目录。还可以在代码中加`console.log`代替`debugger`，避免调试器跳过部分代码。

十五 VS Code调试的性能优化不仅仅是配置问题，还包括代码结构。如果项目中有大量`import`或`require`，建议用`--experimental-loader`指定更高效的加载方式。还可以在`launch.json`里使用`sourceMap`避免调试器加载不必要的模块，或者用`--no-source-maps`直接关闭。调试时如果遇到变量无法显示，可能是因为调试器只支持部分数据类型，这时候需要用`console.log`手动输出。这些经验都是在实际项目中踩出来的，不是教科书上的理论。