1. 知识导图

2. sys模块概述

2.1 模块定义与作用

sys模块是Python标准库中的一个内置模块，提供了与Python解释器及其环境交互的接口。它包含了许多与系统相关的变量和函数，可以用来控制Python运行时的环境参数。

2.2 模块特点

• 与解释器交互：可以访问和修改解释器相关的参数
• 系统相关功能：提供操作系统、平台相关的信息
• 运行时控制：控制程序的执行流程和退出
• 内存管理：提供对Python内存管理的访问接口

2.3 导入方式

import sys

3. 命令行参数处理

3.1 sys.argv

定义与功能

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

参数说明

• 无参数传入
• 自动填充命令行参数

返回值

返回包含命令行参数的列表

示例代码

import sys

print("脚本名称:", sys.argv[0])
print("参数列表:", sys.argv[1:])

# 计算参数和
if len(sys.argv) > 1:
    try:
        numbers = [float(arg) for arg in sys.argv[1:]]
        print("参数和:", sum(numbers))
    except ValueError:
        print("所有参数必须是数字")

注意事项

1. 参数都是字符串类型，需要自行转换
2. 索引0总是脚本名称
3. 参数之间用空格分隔

应用场景举例

• 编写命令行工具
• 脚本参数配置
• 批处理操作

4. 程序退出控制

4.1 sys.exit()

定义与功能

sys.exit([arg]) 用于退出Python程序。可以传递一个可选的整数参数表示退出状态（0表示成功，非0表示错误）。

参数说明

返回值

无返回值，直接退出程序

示例代码

import sys

def main():
    try:
        # 业务逻辑
        result = 10 / 2
        print("结果:", result)
        sys.exit(0)  # 成功退出
    except Exception as e:
        print("错误:", e)
        sys.exit(1)  # 错误退出

if __name__ == "__main__":
    main()

注意事项

1. 实际上是通过抛出SystemExit异常实现
2. 可以在finally块中被捕获
3. 非整数参数会打印到stderr

4.2 sys.exitfunc (已弃用)

注意：Python 3中已移除，应使用atexit模块替代

5. 模块搜索路径管理

5.1 sys.path

定义与功能

sys.path 是一个列表，包含Python解释器查找模块的路径。初始化时从以下位置获取：

1. 包含输入脚本的目录（或当前目录）
2. PYTHONPATH环境变量
3. 安装默认路径

示例代码

import sys

# 打印当前搜索路径
print("模块搜索路径:")
for path in sys.path:
    print(path)

# 添加自定义路径
new_path = "/path/to/your/module"
if new_path not in sys.path:
    sys.path.append(new_path)

注意事项

1. 修改sys.path只影响当前进程
2. 路径顺序决定模块查找顺序
3. 避免在生产环境中动态修改

5.2 路径操作

import sys
import os

# 添加相对路径
sys.path.append(os.path.abspath('../lib'))

# 插入路径到开头
sys.path.insert(0, '/custom/path')

# 删除路径
try:
    sys.path.remove('/unwanted/path')
except ValueError:
    pass

6. 标准输入输出流

6.1 sys.stdin, sys.stdout, sys.stderr

定义与功能

这三个对象分别代表标准输入、输出和错误流。可以重定向这些流来实现输入输出的控制。

示例代码

import sys

# 重定向stdout
class RedirectStdout:
    def __init__(self):
        self.content = []
    
    def write(self, text):
        self.content.append(text)
    
    def flush(self):
        pass

redirect = RedirectStdout()
sys.stdout = redirect

print("这不会显示在控制台")
print("而是存储在redirect对象中")

# 恢复stdout
sys.stdout = sys.__stdout__
print("恢复后的输出:", ''.join(redirect.content))

应用示例：日志记录

import sys
import datetime

class LogFile:
    def __init__(self, filename):
        self.file = open(filename, 'a')
    
    def write(self, message):
        timestamp = datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
        self.file.write(f"[{timestamp}] {message}")
    
    def flush(self):
        self.file.flush()

# 同时输出到控制台和日志文件
class Tee:
    def __init__(self, *files):
        self.files = files
    
    def write(self, obj):
        for f in self.files:
            f.write(obj)
    
    def flush(self):
        for f in self.files:
            f.flush()

log_file = LogFile('app.log')
sys.stdout = Tee(sys.__stdout__, log_file)
sys.stderr = Tee(sys.__stderr__, log_file)

print("这条消息会同时显示在控制台和日志文件中")

注意事项

1. 重定向后记得恢复或关闭文件
2. 确保自定义对象实现write和flush方法
3. 原始流保存在sys.stdin, sys.stdout, sys.__stderr__中

7. 系统信息获取

7.1 版本信息

sys.version

包含Python解释器的版本信息字符串

sys.version_info

包含版本信息的元组，便于比较

import sys

print("版本字符串:", sys.version)
print("版本元组:", sys.version_info)

# 版本检查
if sys.version_info >= (3, 8):
    print("支持Python 3.8+特性")
else:
    print("需要Python 3.8或更高版本")

7.2 平台信息

sys.platform

标识操作系统平台的字符串，如'linux', 'win32', 'darwin'等

import sys

print("当前平台:", sys.platform)

if sys.platform.startswith('win'):
    print("Windows系统特定代码")
elif sys.platform.startswith('linux'):
    print("Linux系统特定代码")

7.3 字节序

sys.byteorder

指示本机字节顺序，'little'或'big'

import sys

print("字节顺序:", sys.byteorder)

8. 内存管理

8.1 sys.getsizeof()

获取对象占用的内存大小（字节）

import sys

data = [i for i in range(1000)]
print("列表大小:", sys.getsizeof(data), "字节")

8.2 引用计数

sys.getrefcount()

获取对象的引用计数（注意：返回值通常比实际多1）

import sys

a = [1, 2, 3]
b = a
print("引用计数:", sys.getrefcount(a))  # 通常为3（a, b, 参数）

内存管理流程图

9. 异常处理

9.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)
    print("异常值:", exc_value)
    print("追踪对象:", exc_traceback)

9.2 sys.excepthook

设置全局异常钩子，处理未捕获的异常

import sys

def custom_excepthook(exc_type, exc_value, exc_traceback):
    print("自定义异常处理:")
    print(f"类型: {exc_type.__name__}")
    print(f"消息: {str(exc_value)}")
    # 可以在这里添加日志记录等操作

sys.excepthook = custom_excepthook

# 测试未捕获异常
raise ValueError("这是一个测试异常")

10. 其他功能

10.1 默认编码

sys.getdefaultencoding()

获取默认字符串编码

import sys

print("默认编码:", sys.getdefaultencoding())

10.2 递归限制

sys.getrecursionlimit()

sys.setrecursionlimit()

控制递归深度限制

import sys

print("当前递归限制:", sys.getrecursionlimit())
sys.setrecursionlimit(2000)

10.3 线程信息

sys._current_frames()

获取当前所有线程的堆栈帧（调试用）

import sys
import threading
import time

def worker():
    time.sleep(100)

t = threading.Thread(target=worker)
t.start()

# 获取线程信息
frames = sys._current_frames()
for thread_id, frame in frames.items():
    print(f"线程 {thread_id}:")
    print(f"  当前文件: {frame.f_code.co_filename}")
    print(f"  当前行号: {frame.f_lineno}")

11. 综合应用示例

11.1 命令行文件处理器

#!/usr/bin/env python3
import sys
import os

def process_file(file_path, output_path=None):
    """处理单个文件"""
    try:
        with open(file_path, 'r') as f:
            content = f.read()
        
        # 示例处理：转换为大写
        processed = content.upper()
        
        if output_path:
            with open(output_path, 'w') as f:
                f.write(processed)
            print(f"处理完成，结果已写入 {output_path}")
        else:
            print(processed)
    except Exception as e:
        print(f"处理文件 {file_path} 时出错: {e}", file=sys.stderr)
        sys.exit(1)

def main():
    if len(sys.argv) < 2:
        print("用法: file_processor.py 输入文件 [输出文件]", file=sys.stderr)
        sys.exit(1)
    
    input_file = sys.argv[1]
    output_file = sys.argv[2] if len(sys.argv) > 2 else None
    
    if not os.path.exists(input_file):
        print(f"错误: 文件 {input_file} 不存在", file=sys.stderr)
        sys.exit(1)
    
    process_file(input_file, output_file)

if __name__ == "__main__":
    main()

11.2 性能分析装饰器

import sys
import time
from functools import wraps

def profile(func):
    """性能分析装饰器"""
    @wraps(func)
    def wrapper(*args, **kwargs):
        start_time = time.perf_counter()
        start_mem = sys.getsizeof(args) + sys.getsizeof(kwargs)
        
        result = func(*args, **kwargs)
        
        elapsed = time.perf_counter() - start_time
        end_mem = sys.getsizeof(result)
        mem_used = end_mem - start_mem
        
        print(f"函数 {func.__name__} 执行时间: {elapsed:.6f} 秒")
        print(f"内存使用: {mem_used} 字节")
        return result
    return wrapper

@profile
def process_large_data(n):
    """模拟大数据处理"""
    data = [i**2 for i in range(n)]
    return sum(data) / len(data) if data else 0

if __name__ == "__main__":
    process_large_data(1000000)

12. 学习路线图

13. 学习总结

13.1 知识点回顾

1. 命令行参数：sys.argv 处理脚本参数
2. 程序控制：sys.exit() 控制程序退出
3. 模块路径：sys.path 管理模块搜索路径
4. 标准流：stdin/stdout/stderr 输入输出控制
5. 系统信息：获取版本、平台等系统信息
6. 内存管理：对象大小和引用计数
7. 异常处理：异常信息和全局钩子

13.2 练习实践

1. 使用 sys.argv 开发灵活的命令行工具
2. 通过 sys.path 实现灵活的模块导入机制
3. 利用 sys.excepthook 实现统一的异常处理
4. 使用 sys.getsizeof() 进行内存优化
5. 通过标准流重定向实现灵活的日志系统

13.3 扩展学习建议

1. 结合 argparse 模块开发更强大的命令行工具
2. 学习 atexit 模块进行退出处理
3. 探索 tracemalloc 进行更详细的内存分析
4. 研究 inspect 模块获取更多运行时信息

通过本教程，我们可以掌握sys模块的核心功能和应用场景。这个模块虽然看起来简单，但在系统编程、工具开发和性能优化中发挥着重要作用。建议在实际项目中多加练习，逐步掌握其高级用法。

持续更新Python编程学习日志与技巧，敬请关注！

#编程# #学习# #python# #在头条记录我的2025#