psutil快速上手:10分钟从零安装到第一个进程监控脚本,超简单入门教程

原创2026-09-21 12:05:362,139 阅读
文章标签:可观测性系统编程

psutil快速上手:10分钟从零安装到第一个进程监控脚本,超简单入门教程

psutil 是一款面向 Python 的跨平台进程与系统监控库。无论你是想查看系统的 CPU、内存占用,还是排查是哪个进程在悄悄消耗资源,几行代码就能搞定。本教程带你走一遍从安装到写出第一个进程监控脚本的完整流程,只需要 10 分钟,无需任何 C 语言基础。

psutil 是什么?Python 系统监控必备库

一句话概括:psutil 就是 Python 版的 ps、top、free、netstat。一个库帮你获取:

  • 🧠 CPU:使用率、核心数、频率、负载
  • 🧩 内存:系统内存与交换分区使用情况
  • 💾 磁盘:分区信息与使用率
  • 🌐 网络:网络流量与连接状态
  • ⚙️ 传感器:温度、电池等硬件信息
  • 📋 进程:每个运行中进程的名称、CPU 与内存占用

它支持 Linux、Windows、macOS 以及主流 BSD 系统。官方文档站还内置了快速搜索,输入关键字几秒钟就能定位到你要的 API:

psutil 官方文档搜索页:快速检索进程监控与系统监控 API

一行安装:psutil 的 pip 安装步骤

psutil 为主流平台提供了预编译 wheel,无需 C 编译器。在终端执行:

pip install psutil

不同平台的详细安装说明,可参考官方文档 docs/install.rst。

确认安装成功

打开 Python 交互环境,打印版本号,能正常输出版本号(如 8.0.0)即安装成功:

import psutil
print(psutil.__version__)

💡 小贴士:版本号定义在 psutil/init.py 中,它也是整个库的 Python 入口文件。

第一个脚本:列出系统所有运行中的进程

入门最常用的第一步需求:查看系统里正在跑哪些进程。命令行里这需要 ps 命令,而用 psutil 只需几行 Python:

import psutil

for p in psutil.process_iter(['pid', 'name']):
    print(p.pid, p.info['name'])

输出类似:

1 systemd
12 kthreadd
7055 python3

process_iter() 会遍历系统中每个进程,pid、name 只是其中可读取的两个字段——这是构建进程监控工具最基础的积木。

30秒系统监控:查看 CPU 与内存占用

系统级监控更简单,每个 API 都直接返回可读结果:

import psutil

print("CPU 使用率:", psutil.cpu_percent(interval=1), "%")
mem = psutil.virtual_memory()
print(f"内存使用率: {mem.percent}%  (共 {mem.total // 2**30} GB)")

输出:

CPU 使用率: 6.7 %
内存使用率: 37.6 %  (共 9 GB)
  • cpu_percent(interval=1) 会测量 1 秒内的 CPU 平均使用率
  • virtual_memory() 一次性返回总内存、已用、可用等字段

CPU、内存、磁盘、网络等全部系统级 API 一览,见 docs/api-overview.rst。

定点监控:查看单个进程的详细状态

拿到目标进程的 PID 后,用 Process() 包起来就能读取它的细节:

import psutil

p = psutil.Process(7055)
print(p.name())             # 例如 'python3'
print(p.memory_info().rss)  # 常驻内存(字节)

这正是 top、pmap 这类工具的核心原理——仓库的 scripts/top.py、scripts/pstree.py 等示例脚本正是基于这些 API 实现的,可以直接阅读源码学习。

性能技巧:用 oneshot() 一次读取多个属性

每读取一个属性都会触发一次系统调用,逐个读取会明显变慢。Process.oneshot() 可以把多次调用批量缓存,速度提升显著:

import psutil

p = psutil.Process(7055)
with p.oneshot():
    p.name()
    p.cpu_times()
    p.memory_info()   # 结果已被缓存,不再重复开销

官方文档中 "Use oneshot() when reading multiple process attributes" 一节对这个原理有直观说明:

psutil 文档 oneshot() 进程监控性能优化章节(深色模式)

常见问题与解决方案

现象 原因与解决办法
抛出 AccessDenied 读取其他用户的进程权限不足,以管理员/root 运行,或自行捕获该异常
cpu_percent() 首次返回 0.0 首次调用只是建立基线,隔一段时间再调用一次,或直接传入 interval 参数
遍历大量进程时偏慢 给 process_iter(attrs) 传入属性列表,并用 oneshot() 缓存读取

下一步:继续深入学习

这只是开始,推荐沿这几条路径继续探索:

至此,你已经完成从安装 psutil 到编写第一个进程监控脚本的全部流程。下次系统变卡时,打开 Python 交互环境,用 psutil 找出"罪魁祸首"吧!

登录后查看全文
psutil