温馨提示×

centos nodejs如何调试配置

小樊
41
2026-10-05 19:14:21
栏目: 编程语言

在 CentOS 上调试 Node.js 应用,常见方式有 命令行调试、VS Code 远程调试、日志调试 等。下面按「从简单到专业」给你一套实用配置方案。


一、基础环境准备(CentOS)

1. 安装 Node.js(推荐 nvm)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
node -v

二、命令行调试(最基础)

1. 使用 node inspect

node inspect app.js

常用命令:

  • c 继续执行
  • n 单步
  • s 进入函数
  • o 跳出
  • repl 查看变量

适合:简单脚本、线上快速排查


三、Chrome DevTools 调试(推荐)

1. 启动调试模式

node --inspect=0.0.0.0:9229 app.js

2. 本地浏览器连接

打开 Chrome:

chrome://inspect
  • 点击 Configure
  • 添加 服务器IP:9229
  • 找到 Target → Inspect

⚠️ 注意防火墙:

firewall-cmd --add-port=9229/tcp --permanent
firewall-cmd --reload

四、VS Code 远程调试(最常用)

1. CentOS 启动

node --inspect=0.0.0.0:9229 app.js

2. VS Code 配置

.vscode/launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to CentOS",
      "address": "服务器IP",
      "port": 9229,
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/project/path"
    }
  ]
}

✅ 支持:

  • 断点
  • 变量监视
  • 调用栈

五、PM2 调试配置(生产常用)

1. 使用 PM2

npm i -g pm2
pm2 start app.js --node-args="--inspect=0.0.0.0:9229"

查看:

pm2 logs
pm2 list

六、日志调试(最稳)

1. 使用 debug 模块

const debug = require('debug')('app');
debug('start server');

启动:

DEBUG=app node app.js

七、常见问题

❌ 无法连接调试端口

  • 检查防火墙
  • 是否绑定 127.0.0.1
  • 云服务器安全组是否放行

❌ 断点不生效

  • 代码未对应
  • source map 问题(TS 项目)

八、推荐组合(实战)

场景 方案
本地开发 VS Code
测试服务器 --inspect
生产环境 日志 + PM2
紧急排查 node inspect

如果你愿意,可以告诉我:

  • ✅ CentOS 版本
  • ✅ Node 版本
  • ✅ 是否在 Docker
  • ✅ 用 VS Code 还是命令行

我可以给你完全定制化的调试配置。

0 踩