2. pprof基础入门：runtime/pprof与net/http/pprof包的区别、基本使用流程、生成profile文件

pprof是Go语言内置的性能分析工具，能够采集程序在运行时的CPU、内存、阻塞、互斥锁、goroutine和线程等关键指标。Go标准库提供了两个核心包来集成pprof：runtime/pprof和net/http/pprof。理解它们的区别与适用场景，是进行性能诊断的第一步。

2.1 两个核心包的区别

2.2 基本使用流程

无论使用哪个包，pprof的分析流程都遵循“采集→保存→分析”三步法：

1. 采集（Sampling）：在目标时段启动采样，pprof以固定频率（CPU默认100Hz，即每10ms一次）记录程序执行栈。
2. 保存（Profile）：将采样数据序列化为二进制profile文件，通常以 .pprof 或 .pb.gz 为后缀。
3. 分析（Analysis）：使用 go tool pprof 命令加载profile文件，进入交互式终端或生成可视化报告。

2.3 使用runtime/pprof生成profile文件

以下代码展示了如何在CLI程序中使用 runtime/pprof 采集CPU和内存profile：

package main

import (
    "os"
    "runtime/pprof"
)

func main() {
    // 创建CPU profile文件
    cpuFile, _ := os.Create("cpu.pprof")
    defer cpuFile.Close()

    // 启动CPU采样
    pprof.StartCPUProfile(cpuFile)
    defer pprof.StopCPUProfile()

    // 执行需要分析的业务逻辑
    doHeavyWork()

    // 创建内存profile文件
    memFile, _ := os.Create("mem.pprof")
    defer memFile.Close()

    // 写入内存profile（需先触发GC以获取准确数据）
    // runtime.GC()
    pprof.WriteHeapProfile(memFile)
}

2.4 使用net/http/pprof生成profile文件

对于HTTP服务，只需在 main.go 中导入 net/http/pprof，即可通过浏览器或命令行获取profile：

package main

import (
    "log"
    "net/http"
    _ "net/http/pprof" // 空导入，自动注册pprof路由
)

func main() {
    // 注册业务路由
    http.HandleFunc("/api", apiHandler)

    // 启动HTTP服务，pprof端点自动可用
    log.Fatal(http.ListenAndServe(":8080", nil))
}

服务启动后，通过以下方式获取profile文件：

• 浏览器访问：http://localhost:8080/debug/pprof/ 查看pprof首页，点击对应链接下载profile。
• 命令行拉取：使用 go tool pprof 直接拉取并进入交互模式：
  go tool pprof http://localhost:8080/debug/pprof/profile?seconds=30
• 保存到本地：curl -o cpu.pprof http://localhost:8080/debug/pprof/profile?seconds=30

2.5 两种方式生成profile的流程对比

2.6 profile文件类型速查

pprof支持多种profile类型，每种类型对应不同的性能维度。下表列出了最常用的六种profile及其含义：