Debian JS如何调试代码

Debian环境下调试JavaScript（JS）代码的常用方法

1. 浏览器开发者工具（适用于前端JS）

适用于调试运行在浏览器中的前端JavaScript代码（如Debian系统中的网页应用）。
操作步骤：

• 打开Chrome/Firefox浏览器，访问目标网页；
• 右键点击页面元素，选择“检查”（或按F12）打开开发者工具；
• 切换至Sources标签，在左侧面板找到项目JS文件；
• 在代码行号左侧点击设置断点（红色圆点）；
• 刷新页面或触发对应事件（如点击按钮），代码执行到断点处会暂停；
• 通过Scope面板查看变量值、Call Stack面板查看调用堆栈，或使用Step Over（F10）、Step Into（F11）等命令控制执行流程。

2. Node.js内置调试器（适用于服务端JS）

适用于调试Node.js运行的服务端JavaScript代码（如Debian上的后端服务、CLI工具）。
基础命令：

• 启动调试模式：在终端运行node inspect your_script.js（your_script.js为入口文件），程序会在第一行暂停；
• 设置断点：在调试命令行输入sb(行号)（如sb(10)），在指定行设置断点；
• 控制执行：输入c（继续）、n（单步执行，不进入函数）、s（单步执行，进入函数）、repl（进入交互式命令行查看变量）；
• 查看信息：输入repl后可输入变量名查看当前值，或输入bt查看调用堆栈。

3. Visual Studio Code（VS Code）调试（推荐）

VS Code是Debian下常用的集成开发环境（IDE），提供直观的图形化调试界面，支持Node.js和浏览器JS调试。
配置步骤：

• 打开项目文件夹，点击左侧运行和调试图标（或按Ctrl+Shift+D）；
• 点击顶部“创建launch.json文件”，选择“Node.js”环境；
• 修改生成的launch.json文件，指定入口文件路径（如"${workspaceFolder}/app.js"），并可选添加"skipFiles": ["<node_internals>/"]（跳过Node.js内部文件）；
• 在代码行号左侧点击设置断点，点击顶部绿色“开始调试”按钮（或按F5）启动调试；
• 调试过程中可通过Variables面板查看变量、Call Stack面板查看调用堆栈，或使用调试工具栏控制执行。

4. 使用debug模块（结构化日志调试）

适用于需要更灵活、模块化日志输出的调试场景（如区分不同模块的调试信息）。
操作步骤：

• 安装模块：在项目目录下运行npm install debug；
• 引入模块：在代码中添加const debug = require('debug')('myapp:module')（myapp:module为命名空间，用于区分不同模块）；
• 输出日志：使用debug('调试信息', variable)（如debug('User logged in:', user.id)）；
• 启用调试：在终端设置DEBUG环境变量，如DEBUG=myapp:module node app.js（仅显示myapp:module命名空间的日志），或DEBUG=* node app.js（显示所有命名空间的日志）。

5. 日志工具（如Winston，适用于生产环境）

适用于需要持久化、分级存储日志的生产环境调试（如Debian服务器上的长期运行应用）。
以Winston为例的操作步骤：

• 安装Winston：运行npm install winston；
• 配置日志：创建logger.js文件，添加以下代码：

  const winston = require('winston');
  const logger = winston.createLogger({
    level: 'info', // 日志级别（info及以上会输出）
    format: winston.format.json(), // 输出JSON格式
    transports: [
      new winston.transports.File({ filename: 'error.log', level: 'error' }), // 错误日志单独存储
      new winston.transports.File({ filename: 'combined.log' }), // 所有日志合并存储
    ],
  });
  module.exports = logger;
  

• 使用日志：在代码中引入logger，如const logger = require('./logger')，然后使用logger.info('Application started')、logger.error('Database connection failed:', error)输出日志；
• 查看日志：通过tail -f error.log（实时查看错误日志）或cat combined.log（查看所有日志）命令查看日志文件。

6. 处理常见调试问题

• 未捕获异常：在代码中添加以下监听，捕获未处理的异常和Promise拒绝，避免程序崩溃：

  process.on('uncaughtException', (error) => {
    console.error('Uncaught Exception:', error);
    // 可选择记录日志或重启应用
  });
  process.on('unhandledRejection', (reason, promise) => {
    console.error('Unhandled Rejection at:', promise, 'reason:', reason);
  });
  

• 内存泄漏：使用heapdump模块生成内存快照，分析内存使用情况：
  • 安装模块：npm install heapdump；
  • 生成快照：在代码中添加require('heapdump').writeSnapshot('/tmp/heapdump.heapsnapshot')（或通过kill -USR2 <pid>命令触发）；
  • 分析快照：使用Chrome DevTools的Memory面板加载.heapsnapshot文件，查看内存占用情况。