# Python-Learning-Resources
本项目用于整理和记录 Python 学习过程中的重要资料与工具文档，方便查阅与系统学习。

# 目录结构

| 类型 | 名称 | 说明 |
| :---: | --- | --- |
| 库 |  |  |
|| [psutil](#psutil-快速概览) | 平台系统监控库，涵盖 CPU、内存、磁盘、网络、进程管理等核心功能。 |
|| [py-cpuinfo](#py-cpuinfo-快速概览) | 用于跨平台获取 CPU 型号、核心数、频率、缓存、指令集等信息。 |

---

当前包含：
- [psutil 详细功能文档](psutil.md)：跨平台系统监控库 `psutil` 的完整使用指南，涵盖 CPU、内存、磁盘、网络、进程管理等核心功能。
- [py-cpuinfo 详细使用文档](py-cpuinfo.md)：轻量级 Python 库 `py-cpuinfo` 的完整使用指南，用于跨平台获取 CPU 型号、核心数、频率、缓存、指令集等信息。

---

## psutil 快速概览

`psutil`（Python System and Process Utilities）是一个跨平台的 Python 库，用于检索系统运行时的信息，如 **CPU、内存、磁盘、网络、进程** 等。它支持 Linux、Windows、macOS、FreeBSD 等主流操作系统，是系统监控、性能分析和运维自动化的重要工具。

### 核心功能模块

- **CPU**：逻辑/物理核心数、使用率、时间统计
- **内存**：虚拟内存、交换内存使用情况
- **磁盘**：分区信息、使用情况、I/O 统计
- **网络**：I/O 统计、连接状态、接口信息
- **进程管理**：PID 获取、资源占用、线程与文件、进程控制
- **系统信息与传感器**：启动时间、用户、温度、电池状态

### 安装

```bash
pip install psutil
```

### 快速开始

```python
import psutil

print(psutil.cpu_percent(interval=1))   # 查看 CPU 使用率

mem = psutil.virtual_memory()   # 查看内存信息
print(f"Total: {mem.total}, Available: {mem.available}, Used: {mem.percent}%")

print(psutil.disk_usage('/'))   # 查看磁盘使用情况

print(psutil.pids())    # 查看所有进程 PID
```

详细用法请参考 [psutil.md](psutil.md)。

---

## py-cpuinfo 快速概览

`py-cpuinfo` 是一个轻量级的 Python 库，用于**跨平台获取 CPU 信息**，无需安装系统级依赖，适用于 Linux / Windows / macOS / BSD 等系统。它常用于性能分析、环境检测、硬件审计、自动化运维等场景。

### 核心功能

- **基础信息**：CPU 型号、厂商、架构、家族编号
- **核心与线程**：物理核心数、逻辑 CPU 数量、每核线程数
- **频率信息**：标称主频、当前实际主频
- **缓存信息**：L1/L2/L3 缓存大小
- **指令集支持**：AVX、SSE、AES 等指令集检测

### 安装

```bash
pip install py-cpuinfo
```

### 快速开始

```python
from cpuinfo import get_cpu_info

info = get_cpu_info()
print(info['brand_raw'])  # 输出 CPU 型号
print(f"物理核心: {info['cores']}, 逻辑核心: {info['count']}")
print(f"标称频率: {info['hz_advertised_friendly']}")
```

详细用法请参考 [py-cpuinfo.md](py-cpuinfo.md)。

---

### 适用场景

**psutil 适用场景：**
- 系统资源实时监控
- 服务器性能分析
- 进程级资源审计
- 自动化运维脚本
- 安全/异常进程检测

**py-cpuinfo 适用场景：**
- 性能调优与环境检测
- 软件兼容性判断
- 硬件审计与资产盘点
- 自动化运维脚本
- CPU 特性检测（如 AVX、AES 支持）

---

> 更多 Python 学习资源将持续更新到此仓库。