教程文档【免费下载链接】30-seconds-of-codeCoding articles to level up your development skills项目地址https://gitcode.com/gh_mirrors/30/30-seconds-of-code点击查看免费下载Node.js 从v6.3.0起就原生支持使用 Chrome 开发者工具Chrome Developer Tools进行调试无需安装任何第三方调试器。本文基于 30-seconds-of-code 仓库中的 Node.js 调试速查文章完整梳理从启动带断点的 Node.js 进程、在 Chrome 中打开about:inspect页面到借助 DevTools 面板完成断点、单步、调用栈分析与表达式求值的一整套实战流程帮助你像调试前端代码一样调试后端服务。说明本文涉及的调试流程适用于任意 Node.js 应用该文章在仓库中位于 JavaScript 文章集合content/collections/js/node.yaml中languageMatcher: javascript、tagMatcher: node是 JavaScript 文章集合 下 Node.js 主题的一篇入门级速查文档并可通过/articles/s/nodejs-chrome-debugging跳转见 redirects.yaml。准备工作安装合适的 Node.js 版本Chrome 开发者工具对 Node.js 的支持始于v6.3.0该版本首次内置了基于 Chrome DevTools 协议的调试器。因此使用本文的方法前请确认本机 Node.js 版本不低于6.3.0node --version若输出版本号低于6.3.0需要先升级 Node.js。推荐使用 Node.js 官方维护的当前活跃 LTS长期支持版本——自v6.3.0以来这一调试能力被完整保留并持续增强新版本同样适用且稳定性与性能更佳。以 --inspect-brk 启动让进程在首行等待调试器调试的第一步是启动 Node.js 进程并让其主动暴露调试端口。核心命令如下node --inspect-brk index.js其中--inspect以调试模式启动 Node.js 进程默认在127.0.0.1:9229端口开启 WebSocket 调试会话进程会正常执行代码--inspect-brk在--inspect的基础上在脚本第一行执行前就暂停break等待调试器连接后再继续。这是「从零开始调试」最常用的方式因为应用启动阶段如模块初始化、环境变量读取、数据库连接往往正是 bug 的高发区域index.js替换为你的实际入口文件例如server.js、app.js等。启动后终端通常会输出类似以下信息Debugger listening on ws://127.0.0.1:9229/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx For help, see: https://nodejs.org/en/docs/inspector这表示调试会话已经建立等待 DevTools 客户端连接。常用调试启动参数速查参数作用典型场景node --inspect index.js启动调试但不暂停进程正常运行想连接调试器、在运行中手动设置断点node --inspect-brk index.js启动调试并在首行暂停从应用入口开始逐步排查node --inspecthost:port index.js指定监听地址与端口远程调试、容器/虚拟机内的 Node 进程node --inspect-brk9229 index.js指定端口并首行暂停端口冲突时显式指定调试端口需要说明的是--inspect系列标志针对的是当前被调试的 Node.js 进程本身它不会改变业务代码的执行逻辑只会额外开启一个调试通道因此可以放心用于本地开发环境。打开 about:inspect 并连接到 Node.js 实例Node.js 进程已处于调试等待状态后接下来在 Chrome 浏览器中完成连接打开 Chrome在地址栏输入并回车访问内部页面about:inspect页面中的Remote Target区域会自动列出可调试的目标——此时应能看到你的 Node.js 进程及其命令行信息如上面的node --inspect-brk index.js点击目标条目下方的Open dedicated DevTools for Node按钮Chrome 会打开一个独立的开发者工具窗口该窗口已连接到你的 Node.js 进程。由于使用了--inspect-brk此时 DevTools 窗口内的代码会停留在index.js的第一行等待你执行下一步调试动作。这就是上图中about:inspect页面所展示的「发现目标 → 点击连接」的交互流程。在 DevTools 中进行断点调试连接成功后就可以像调试前端 JavaScript 一样使用完整的调试面板Sources源代码面板查看所有加载的脚本文件点击行号左侧即可设置/取消断点支持条件断点右键断点设置表达式、日志断点等Step Over / Step Into / Step Out单步跳过、步入函数、步出函数逐行追踪执行路径Watch监视与 Scope作用域实时查看变量值与当前调用栈的局部变量、闭包变量、全局变量Console控制台在断点处直接执行任意表达式、调用函数或修改变量用于现场验证假设Call Stack调用栈回溯当前执行位置来自哪个函数调用链快速定位问题源头Breakpoints 面板集中管理所有断点可临时禁用或删除。一个典型的调试循环是先在可疑函数处设置断点 → 使用刷新/重放触发代码路径 → 命中断点后结合 Watch 与 Console 检查变量 → 用 Step Into 深入底层调用 → 修正逻辑后继续运行。结束调试与后续建议调试完成后在 DevTools 窗口点击 Resume继续或直接关闭窗口即可结束调试会话CtrlC 终止终端中的 Node.js 进程同样会释放调试端口。几点实用建议优先使用--inspect-brk而非--inspect对于需要观察初始化过程的场景首行暂停能确保调试器「接得住」应用启动阶段的全部执行细节对进程管理器中的服务如果 Node.js 应用由 PM2、Docker 等进程管理器启动可为其额外传递--inspect参数并映射调试端口实现远程调试将该文章作为速查入口本文源于仓库中的 nodejs-chrome-debugging.md其 front matter 使用tags: [node, debugging]、封面图为bug适合作为 Node.js 调试主题的快速参考仓库还提供了 Node.js 文章集合 以便浏览更多服务端相关技巧。现在你已经掌握了从命令行启动到 DevTools 断点调试的完整链路可以把这套方法直接应用到日常的 Node.js 开发与排错中。赞分享教程文档【免费下载链接】30-seconds-of-codeCoding articles to level up your development skills项目地址https://gitcode.com/gh_mirrors/30/30-seconds-of-code点击查看免费下载相关推荐从调试到优化Selenoid中Chrome开发者工具(DevTools)的全链路应用指南从调试到优化Selenoid中Chrome开发者工具 DevTools 的全链路应用指南 引言为什么Selenoid的DevTools集成是自动化测试的颠覆WordPress块绑定架构解析模式覆盖与动态内容替换的高效实现方案WordPress块绑定架构解析模式覆盖与动态内容替换的高效实现方案 WordPress 6.5版本引入的块绑定技术代表了内容管理架构的重大革新通过将区块属后端CMSgtop内存泄漏分析使用Chrome DevTools调试Node.js监控工具gtop内存泄漏分析使用Chrome DevTools调试Node.js监控工具 你是否遇到过终端监控工具运行一段时间后卡顿甚至崩溃的情况作为系统管理员或开指标监控上一篇如何让Minecraft帧率翻倍Fabulously Optimized终极优化指南下一篇智能开发工具箱5个提升编程效率的实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考