性能分析器

技能简介

perf-profiler 是一款跨语言的应用性能分析工具，支持 CPU 剖析、内存分析、火焰图生成、函数基准测试、API 负载测试及数据库查询优化。适用于 Node.js、Python、Go 等多种运行时环境。

业务背景

性能分析器帮助开发团队快速定位应用卡顿、响应慢等性能瓶颈。通过CPU剖析和内存分析，业务人员能直观了解哪些代码或接口消耗资源最多；火焰图将复杂的技术数据转化为可视化热点路径，让非技术管理者也能理解问题所在。部署前还可模拟真实流量进行负载测试，提前发现系统承载风险，避免上线后影响用户体验。

落地案例：某电商平台大促前使用性能分析器对核心下单接口进行全链路检测：先通过CPU剖析发现优惠券计算模块占用过高，火焰图锁定递归算法为瓶颈；再对优化后的代码进行基准测试对比，确认耗时降低；最后用负载测试模拟峰值流量，验证数据库连接池配置充足。整个过程在预发环境完成，零生产风险。

能做什么

• 诊断应用或函数运行缓慢的原因
• 测量 CPU 与内存占用情况
• 生成火焰图以可视化热点代码路径
• 对函数或接口进行基准测试
• 部署前对 API 进行负载测试
• 定位并修复内存泄漏问题
• 优化数据库查询性能
• 对比代码变更前后的性能差异

使用说明

安装依赖

本技能依赖以下任一命令行工具：

• Node.js（node）
• Python 3（python3）
• Go（go）
• cURL（curl）
• Apache Bench（ab）

可选安装 hyperfine 以获得更精确的基准测试能力：

# macOS
brew install hyperfine

# Linux (Debian/Ubuntu)
apt-get install hyperfine

# 其他系统见 https://github.com/sharkdp/hyperfine

基础用法

1. 命令行计时：使用 time 或 hyperfine 测量命令执行耗时

# 单次计时
time my-command --flag

# 多次统计平均耗时
for i in $(seq 1 10); do
  /usr/bin/time -f "%e" my-command 2>&1
done | awk '{sum+=$1; sumsq+=$1*$1; count++} END {
  avg=sum/count;
  stddev=sqrt(sumsq/count - avg*avg);
  printf "runs=%d avg=%.3fs stddev=%.3fs\n", count, avg, stddev
}'

# 使用 hyperfine 对比两个命令
hyperfine 'command-a' 'command-b'
hyperfine --warmup 3 --runs 20 'my-command'

2. Node.js CPU 剖析：生成 .cpuprofile 文件并在 Chrome DevTools 中分析

node --cpu-prof app.js
node --cpu-prof --cpu-prof-interval=100 app.js

3. Node.js 堆快照：检测内存泄漏

node --heap-prof app.js

4. Python cProfile 分析：

python3 -m cProfile -s cumulative my_script.py
python3 -m cProfile -o profile.prof my_script.py

输入与输出

见下方输入与输出表格。

风险提示

• 生产环境剖析可能带来 5%-20% 的性能开销，建议在隔离环境或低峰期执行
• 堆快照文件体积较大，需确保磁盘空间充足
• 负载测试工具（如 ab）可能对目标服务造成真实压力，避免对生产系统直接测试
• 火焰图解读需要一定经验，复杂调用栈可能产生误导性结论

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gitgoodordietrying/perf-profiler/SKILL.md
来源类型：GitHub 仓库