Python sys 模块

Python3 学习笔记 · 整理自菜鸟教程

一句话

sys 模块直接与 Python 解释器打交道：读命令行参数、控制标准输入输出、调整模块搜索路径、退出程序，都靠它。

要点

• sys.argv：命令行参数列表，第 0 个是脚本名，其后才是用户传入的参数。
• sys.exit([code])：退出程序，本质是抛出 SystemExit；0 表示正常，非 0 表示出错。
• sys.path：模块搜索路径列表，运行时可 append/insert 动态加目录。
• sys.stdin / sys.stdout / sys.stderr：三个标准流，可重定向。
• sys.version 返回字符串，sys.version_info 返回可比较的元组。
• sys.platform：平台标识（darwin / win32 / linux）。
• sys.modules：已加载模块的字典，可用来判断模块是否已导入。
• sys.getsizeof(obj)：对象占用字节数（含解释器开销，非精确内存）。
• sys.maxsize：当前平台 Py_ssize_t 最大值，常当“无限大”用。
• sys.setrecursionlimit() / sys.getrecursionlimit()：读写递归深度上限。
• sys.getdefaultencoding()：解释器默认编码，通常是 utf-8。
• sys.exc_info()：返回当前异常三元组 (类型, 值, traceback)。

语法 / 常用方法

代码示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

import sys

# 1. 命令行参数：python script.py a b
print('脚本名:', sys.argv[0])
print('用户参数:', sys.argv[1:])          # 从下标 1 开始才是真正的参数

# 2. 版本与平台
print('版本:', sys.version_info)          # sys.version_info(major=3, ...)
if sys.version_info < (3, 8):
    sys.exit('需要 Python 3.8 及以上')

# 3. 模块搜索路径：临时加一个目录
sys.path.append('./mylib')
print('路径条数:', len(sys.path))

# 4. 标准流：输出到 stderr（错误信息）
print('这行会走标准错误', file=sys.stderr)

# 5. 已加载模块
print('os 已加载:', 'os' in sys.modules)

# 6. 对象大小与上限
print('列表占用字节:', sys.getsizeof([1, 2, 3]))
print('递归上限:', sys.getrecursionlimit())

# 7. 正常退出（0 表示成功）
if len(sys.argv) < 2:
    print('未传参数，正常结束')
    sys.exit(0)

易错点

• sys.argv[0] 是脚本名，不是第一个参数；取用户参数应从 sys.argv[1:] 开始，且要防越界。
• sys.exit(1) 是主动退出，不是崩溃；在 try 里会被 except SystemExit 捕获，别乱吞。
• sys.path 修改只影响当前进程，重启即失效；别把它当永久配置。
• sys.modules 里存在某模块不代表导入成功（可能是半初始化状态），判断“是否装了”应更谨慎。
• sys.getsizeof 只算对象本身，不含它引用的子对象，别用来估算整个数据结构的真实内存。
• 改 sys.setrecursionlimit 只是放宽上限，过深仍可能让 C 栈溢出崩溃，递归深还是要改迭代。