Python 标准库 sys 模块详解

print(sys.int_info)

4. 线程信息

sys.thread_info 返回关于线程支持的信息，如线程锁类型、最大线程 ID 等。

print(sys.thread_info)

三、解释器状态与环境

1. 内建模块列表

sys.builtin_module_names 列出所有编译进解释器的内建模块名称。

print(sys.builtin_module_names)

2. 内存分配块数

sys.getallocatedblocks() 返回当前分配的内存块数量，主要用于调试内存泄漏。

print(sys.getallocatedblocks())

3. 递归深度限制

sys.getrecursionlimit() 获取当前递归深度的限制值，防止无限递归导致栈溢出。

print(sys.getrecursionlimit())

可通过 sys.setrecursionlimit(limit) 调整该限制。

4. 线程切换间隔

sys.getswitchinterval() 获取解释器线程切换的时间间隔（秒）。

print(sys.getswitchinterval())

可通过 sys.setswitchinterval(interval) 修改。

5. 安装路径信息

• sys.base_prefix: Python 基础安装路径。
• sys.prefix: 当前 Python 环境的路径（虚拟环境中通常不同）。
• sys.base_exec_prefix: 基础执行前缀。

print(sys.prefix)
print(sys.base_prefix)

四、标准输入输出流

sys 模块提供了三个标准流对象，用于处理程序的输入输出。

• sys.stdin: 标准输入流，默认关联键盘输入。
• sys.stdout: 标准输出流，默认关联终端显示。
• sys.stderr: 标准错误流，用于输出错误信息，通常不缓冲。

示例：重定向输出

import sys
original_stdout = sys.stdout
with open('output.txt', 'w') as f:
    sys.stdout = f
    print('This goes to file')
sys.stdout = original_stdout

五、平台相关信息

1. 平台标识

sys.platform 返回操作系统标识符。

• Windows: 'win32'
• Linux: 'linux'
• macOS: 'darwin'

print(sys.platform)

2. 最大整数值

sys.maxsize 返回最大可用索引值，取决于系统位数（32 位或 64 位）。

print(sys.maxsize)

3. 默认编码

sys.getdefaultencoding() 获取默认字符串编码格式，通常为 'utf-8'。

print(sys.getdefaultencoding())

4. 文件系统编码

• sys.getfilesystemencoding(): 获取文件系统编码名称。
• sys.getfilesystemencodeerrors(): 获取文件名转换时的错误模式。

print(sys.getfilesystemencoding())

5. 字节顺序

sys.byteorder 返回本地 CPU 的字节序，值为 'little' 或 'big'。

print(sys.byteorder)

6. 模块搜索路径

sys.path 是一个列表，定义了 Python 解释器查找模块的路径，由环境变量 PYTHONPATH 及安装默认值组成。

for p in sys.path:
    print(p)

可通过 sys.path.append('/new/path') 动态添加路径。

7. 已加载模块

sys.modules 字典存储了所有已导入的模块对象。

print(sys.modules['os'])

8. 对象引用计数

sys.getrefcount(object) 返回对象的引用次数（注意：调用本身会增加一次计数）。

x = []
print(sys.getrefcount(x))

9. 对象大小

sys.getsizeof(object) 返回对象占用的内存字节数。

print(sys.getsizeof(256))

10. Unicode 最大值

sys.maxunicode 返回 Unicode 字符的最大码点值。

print(sys.maxunicode)

11. 浮点数 repr 风格

sys.float_repr_style 控制浮点数转换为字符串时的风格（short 或 legacy）。

print(sys.float_repr_style)

六、命令行参数与控制

1. 命令行参数

sys.argv 是一个列表，包含传递给脚本的命令行参数。第一个元素是脚本名称。

import sys
if len(sys.argv) > 1:
    print(f"Arguments: {sys.argv[1]}")
else:
    print("No arguments provided")

2. 退出程序

sys.exit([code]) 抛出 SystemExit 异常以终止程序。可选参数为退出状态码，0 表示成功。

import sys
try:
    # 某些逻辑
    if error_condition:
        sys.exit(1)
except SystemExit:
    pass

七、异常处理信息

1. 获取异常信息

sys.exc_info() 返回当前正在处理的异常信息三元组 (type, value, traceback)。常用于日志记录或异常捕获后的处理。

import sys
try:
    1 / 0
except:
    exc_type, exc_value, exc_traceback = sys.exc_info()
    print(exc_type, exc_value)

八、最佳实践与注意事项

1. 避免过度依赖：sys 模块提供的功能通常涉及底层实现，跨平台使用时需注意差异（如 sys.platform）。
2. 路径管理：修改 sys.path 需谨慎，可能导致模块冲突或安全漏洞。
3. 递归限制：调整 setrecursionlimit 可能引发栈溢出崩溃，应谨慎操作。
4. 编码问题：在 Python 3 中，默认编码通常为 UTF-8，但在处理文件 I/O 时建议显式指定编码。

通过合理使用 sys 模块，开发者可以更好地控制程序运行环境，实现更灵活的系统级交互。