如何为Node.js C++原生扩展进行CPU性能分析？

你遇到的问题很典型——Node.js自带的--prof确实只聚焦于V8主线程的JS和内置代码执行，完全不会跟踪libuv线程池里的原生代码执行情况。要分析这部分的CPU占用，得用系统级的性能分析工具，下面分平台给你具体步骤：

第一步：确保你的C++扩展编译时保留调试符号 #

不管用什么工具，没有调试符号的话，你只能看到一堆内存地址，根本不知道对应你的哪个函数。所以在binding.gyp里加上调试编译选项：

{
  "targets": [
    {
      "target_name": "your_extension",
      "cflags": ["-g"],          // 给C代码加调试信息
      "cxxflags": ["-g"],        // 给C++代码加调试信息
      "ldflags": ["-g"],         // 链接时保留符号
      "defines": ["NODE_GYP_MODULE_NAME=your_extension"]
    }
  ]
}

然后重新编译：node-gyp clean configure build

第二步：分平台使用性能分析工具 #

Linux 平台：使用 perf #

perf是Linux下最强大的系统性能分析工具，能捕获进程所有线程的CPU调用栈：

1. 先安装perf（如果没装的话）：

   sudo apt install linux-tools-common linux-tools-$(uname -r)
   

2. 启动你的Node应用并记录性能数据：

   perf record -g -- node your-app.js
   

   -g参数会记录调用栈信息，方便你追踪函数调用链。
3. 查看分析报告：

   perf report
   

   在报告里，你可以按线程筛选，找到libuv的工作线程（通常名字带uv__work相关），然后就能看到你的C++函数的CPU占用占比、调用次数等信息了。

macOS 平台：使用 Instruments 或 dtrace #

1. Instruments（图形化，推荐）：
   • 打开Xcode → 顶部菜单 Xcode → Open Developer Tool → Instruments
   • 选择Time Profiler模板
   • 点击左上角的Choose Target，选择你的Node.js可执行文件，然后输入你的应用入口文件路径作为参数
   • 点击录制按钮启动分析，运行你的应用直到完成
   • 录制结束后，在左侧线程列表里找到libuv的工作线程（名字通常包含uv_work），就能看到你的C++函数的CPU耗时分布了。
2. dtrace（命令行）：
   如果你喜欢命令行，可以用dtrace的profile脚本：

   sudo dtrace -n 'profile-997 /execname == "node"/ { @[ustack()] = count(); }'
   

   运行后让你的应用执行，按Ctrl+C停止，就能看到所有线程的调用栈统计。

Windows 平台：使用 Windows Performance Toolkit #

1. 安装Windows Performance Toolkit（属于Windows SDK的一部分）
2. 打开Windows Performance Recorder，创建一个新的配置，勾选CPU Usage选项
3. 启动录制，然后运行你的Node应用
4. 录制结束后，用Windows Performance Analyzer打开生成的.etl文件，筛选你的Node进程，就能看到所有线程的CPU调用栈，包括libuv线程池里的C++代码。

额外提示 #

• 如果你的扩展代码是异步执行在libuv线程池的，确保测试时能充分触发这部分代码（比如多并发请求），不然采样数据可能不够准确。
• 不要用strip命令处理你的扩展.so/.node文件，否则会丢失调试符号，工具无法识别函数名。

内容的提问来源于stack exchange，提问作者matheuscscp