psutil快速上手:10分钟从零安装到第一个进程监控脚本,超简单入门教程
psutil快速上手:10分钟从零安装到第一个进程监控脚本,超简单入门教程
psutil 是一款面向 Python 的跨平台进程与系统监控库。无论你是想查看系统的 CPU、内存占用,还是排查是哪个进程在悄悄消耗资源,几行代码就能搞定。本教程带你走一遍从安装到写出第一个进程监控脚本的完整流程,只需要 10 分钟,无需任何 C 语言基础。
psutil 是什么?Python 系统监控必备库
一句话概括:psutil 就是 Python 版的 ps、top、free、netstat。一个库帮你获取:
- 🧠 CPU:使用率、核心数、频率、负载
- 🧩 内存:系统内存与交换分区使用情况
- 💾 磁盘:分区信息与使用率
- 🌐 网络:网络流量与连接状态
- ⚙️ 传感器:温度、电池等硬件信息
- 📋 进程:每个运行中进程的名称、CPU 与内存占用
它支持 Linux、Windows、macOS 以及主流 BSD 系统。官方文档站还内置了快速搜索,输入关键字几秒钟就能定位到你要的 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" 一节对这个原理有直观说明:
常见问题与解决方案
| 现象 | 原因与解决办法 |
|---|---|
抛出 AccessDenied |
读取其他用户的进程权限不足,以管理员/root 运行,或自行捕获该异常 |
cpu_percent() 首次返回 0.0 |
首次调用只是建立基线,隔一段时间再调用一次,或直接传入 interval 参数 |
| 遍历大量进程时偏慢 | 给 process_iter(attrs) 传入属性列表,并用 oneshot() 缓存读取 |
下一步:继续深入学习
这只是开始,推荐沿这几条路径继续探索:
- 📖 完整 API 参考:docs/api.rst
- 🧪 官方测试用例(API 用法的好素材):tests/test_system.py
- 🛠️ 监控类示例脚本:scripts/ 目录下的 top、netstat、disk_usage 等
至此,你已经完成从安装 psutil 到编写第一个进程监控脚本的全部流程。下次系统变卡时,打开 Python 交互环境,用 psutil 找出"罪魁祸首"吧!

