`sys` 是 Python 的**内置标准库模块**，全称是 *system*，用于访问与 Python 解释器紧密相关的信息和功能。它不依赖外部安装，只要 Python 存在即可直接 `import sys` 使用。`sys` 模块是编写健壮、可移植、调试友好及系统级交互程序（如命令行工具、服务脚本、异常处理、路径管理）的基石。 --- ### ✅ 核心用途与常用属性/函数详解 #### 1. **运行时环境与解释器信息** ```python import sys print(sys.version) # Python 版本字符串，如 '3.12.4 (main, Jun 6 2024, 18:27:53) [Clang 15.0.0 (clang-1500.3.9.4)]' print(sys.version_info) # 命名元组：sys.version_info(major=3, minor=12, micro=4, releaselevel='final', serial=0) print(sys.platform) # 平台标识符：'linux', 'win32', 'darwin', 'cygwin' 等 print(sys.executable) # 当前 Python 解释器的绝对路径，如 '/usr/bin/python3' print(sys.argv) # 命令行参数列表：[脚本名, arg1, arg2, ...]（`argv[0]` 是脚本路径） ``` #### 2. **标准输入/输出/错误流（可重定向）** ```python import sys # 默认等价于 print(...), input(), print(..., file=sys.stderr) sys.stdout.write("Hello stdout\n") # 不自动换行（需手动 \n） sys.stderr.write("Error occurred!\n") # 输出到 stderr（常用于错误/警告） sys.stdin.readline().strip() # 等效于 input()，但返回带 \n 的字符串 # ⚠️ 重定向示例（常用于测试或日志捕获） original_out = sys.stdout with open("output.log", "w") as f: sys.stdout = f print("This goes to file") sys.stdout = original_out # 恢复 ``` #### 3. **模块与路径管理（关键！影响 import 行为）** ```python print(sys.path) # Python 查找模块的目录列表（str list），顺序搜索 # 示例输出：['', '/usr/lib/python312.zip', '/usr/lib/python3.12', ...] # ✅ 动态添加自定义模块路径（推荐用 PYTHONPATH 环境变量，次选用此） sys.path.insert(0, "/my/project/libs") # 插入最前，优先加载 # ❌ 注意：修改 sys.path 不会实时刷新已导入模块（需 reload 或重启解释器） ``` #### 4. **异常与退出控制** ```python import sys # 获取当前异常信息（常用于 except 块中） try: 1 / 0 except Exception: exc_type, exc_value, exc_traceback = sys.exc_info() print(f"Error: {exc_type.__name__}: {exc_value}") # 安全退出程序（替代 os._exit()，会执行 finally 和 atexit 注册函数） sys.exit(0) # 正常退出（code=0） sys.exit("Failed!") # 打印消息后退出（code=1） # sys.exit() 等价于 raise SystemExit(...) ``` #### 5. **内存与递归限制** ```python print(sys.getrecursionlimit()) # 默认通常 1000，防止栈溢出 sys.setrecursionlimit(2000) # 可调高（慎用！可能导致 segfault） print(sys.getsizeof([1,2,3])) # 返回对象内存占用字节数（近似值，不含引用对象） ``` #### 6. **其他实用功能** ```python # 获取已加载模块字典（可用于调试循环导入） print(list(sys.modules.keys())[:5]) # 如 ['sys', 'builtins', 'warnings', '__main__', 'posix'] # 判断是否在交互式环境（如 IPython/Jupyter） print(sys.flags.interactive) # True if -i flag used print(hasattr(sys, 'ps1')) # 更可靠：True in interactive mode # 获取最大整数（仅 CPython，已弃用；现代 Python 整数无上限） # print(sys.maxint) # Python 2 only → 现在用 float('inf') 或不关心 ``` --- ### ⚠️ 重要注意事项 | 场景 | 风险 | 建议 | |------|------|------| | `sys.path.append(...)` | 可能导致模块冲突或覆盖标准库 | 优先用 `PYTHONPATH` 或虚拟环境 | | `sys.stdout = ...` | 全局影响，多线程下不安全 | 用 `contextlib.redirect_stdout()` 上下文管理器 | | `sys.setrecursionlimit()` | 过高引发段错误（segfault） | 仅在明确需要且测试充分时调整 | | `sys.exc_info()` | 返回的 traceback 对象会阻止 GC 回收帧对象 | 在 `except` 中尽快处理，避免长期持有 | --- ### 🧩 实用示例：命令行参数解析（轻量级） ```python import sys if len(sys.argv) < 2: print("Usage: python script.py <filename>") sys.exit(1) filename = sys.argv[1] try: with open(filename) as f: print(f"Lines: {sum(1 for _ in f)}") except FileNotFoundError: print(f"Error: {filename} not found.") sys.exit(2) ``` > ✅ 提示：生产环境推荐用 `argparse` 模块替代手动解析 `sys.argv`，但理解 `sys.argv` 是底层基础。 ---