Python `os` 和 `os.path` 模块是进行文件和目录操作、路径管理的核心工具。它们提供了与操作系统交互的统一接口，是跨平台文件系统编程的基础 [ref_1][ref_4]。 ## 核心模块与功能概览 下表对比了 `os` 和 `os.path` 模块的主要职责： | 模块 | 主要功能 | 特点 | | :--- | :--- | :--- | | **`os`** | 与操作系统直接交互的函数。如：进程管理、环境变量、文件/目录的**增删改查**、运行系统命令等。 | 功能广泛，直接调用系统接口 [ref_4][ref_5]。 | | **`os.path`** | 专门用于**路径名操作**的函数集合。如：路径拼接、分割、判断属性（是否存在、是文件还是目录）等。 | 专注于路径字符串的处理，不要求路径真实存在 [ref_1][ref_3]。 | ## 一、os模块常用函数详解 ### 1. 目录与路径操作 ```python import os # 1. 获取当前工作目录 (Get Current Working Directory) current_path = os.getcwd() print(f"当前工作目录: {current_path}") # 例如：/home/user/project [ref_1][ref_5] # 2. 改变当前工作目录 (Change Directory) os.chdir('/tmp') print(f"改变后目录: {os.getcwd()}") # 输出：/tmp [ref_1][ref_5] # 3. 列出目录内容 (List Directory) items = os.listdir('.') # 参数为路径字符串，默认为当前目录 '.' print(f"当前目录内容: {items}") # 返回一个包含文件和目录名的列表 [ref_1][ref_5] # 4. 创建目录 os.mkdir('new_folder') # 创建单级目录，父目录必须存在，否则报错 [ref_1][ref_5] os.makedirs('path/to/nested/folder', exist_ok=True) # 创建多级目录，exist_ok=True 可避免目录已存在时报错 [ref_1][ref_6] ``` ### 2. 文件与目录管理 ```python # 5. 删除文件或目录 os.remove('file.txt') # 删除一个文件 [ref_1][ref_5] os.rmdir('empty_folder') # 删除一个**空**目录 [ref_1][ref_5] import shutil shutil.rmtree('folder_with_content') # 删除非空目录（需要 shutil 模块）[ref_1] # 6. 重命名文件或目录 os.rename('old_name.txt', 'new_name.txt') # 也可用于移动文件（在同一文件系统内）[ref_1][ref_5] # 7. 遍历目录树 for root, dirs, files in os.walk('.'): # root: 当前遍历到的目录路径 # dirs: root目录下的子目录名列表 # files: root目录下的文件名列表 print(f"在 {root} 中发现 {len(files)} 个文件") # 深度优先或广度优先遍历所有子目录 [ref_1][ref_5] ``` ## 二、os.path模块常用函数详解 此模块主要用于处理路径字符串，是路径操作的利器。 ### 1. 路径分割与拼接 ```python import os file_path = "/home/user/docs/report.txt" # 1. 获取路径的目录部分和文件名部分 dir_name = os.path.dirname(file_path) # 输出：/home/user/docs [ref_1][ref_3] base_name = os.path.basename(file_path) # 输出：report.txt [ref_1][ref_3] print(f"目录: {dir_name}, 文件名: {base_name}") # 2. 路径拼接 (安全，推荐使用) new_path = os.path.join(dir_name, 'data', '2023', 'file.csv') print(f"拼接后路径: {new_path}") # 输出：/home/user/docs/data/2023/file.csv [ref_1][ref_3] # 3. 路径分割（将路径拆分为目录部分和文件名部分的元组） split_result = os.path.split(file_path) print(f"路径分割: {split_result}") # 输出：('/home/user/docs', 'report.txt') [ref_1][ref_3] # 4. 分割文件名和扩展名 file_name, file_ext = os.path.splitext('report.txt') print(f"文件名: {file_name}, 扩展名: {file_ext}") # 输出：文件名: report, 扩展名: .txt [ref_1][ref_3] ``` ### 2. 路径判断与信息获取 ```python # 5. 判断路径是否存在 if os.path.exists('/some/path'): print("路径存在") # [ref_2][ref_3] # 6. 判断是文件还是目录 if os.path.isfile('report.txt'): print("这是一个文件") # [ref_1][ref_3] if os.path.isdir('/home/user'): print("这是一个目录") # [ref_1][ref_3] # 7. 获取文件大小、修改时间等信息 file_size = os.path.getsize('report.txt') # 返回字节数 [ref_1][ref_3] mod_time = os.path.getmtime('report.txt') # 返回时间戳（最后修改时间）[ref_1][ref_3] from datetime import datetime print(f"文件大小: {file_size} bytes, 最后修改于: {datetime.fromtimestamp(mod_time)}") # [ref_1] ``` ## 三、综合应用场景示例 ### 场景：清理指定目录下所有 `.log` 备份文件 ```python import os def clean_backup_logs(directory): """ 删除指定目录及其子目录中所有以 .log.bak 结尾的备份文件。 """ for root, dirs, files in os.walk(directory): for file in files: if file.endswith('.log.bak'): file_path = os.path.join(root, file) try: os.remove(file_path) print(f"已删除: {file_path}") except OSError as e: print(f"删除失败 {file_path}: {e}") # 使用示例 clean_backup_logs('/var/log/myapp') ``` 此函数综合运用了 `os.walk()` 遍历目录树，`os.path.join()` 安全拼接路径，`str.endswith()` 判断文件类型，以及 `os.remove()` 执行删除操作 [ref_1][ref_5]。 ### 场景：安全创建用户数据存储路径 ```python def setup_user_data_dir(base_dir, user_id): """ 为用户安全创建数据存储目录结构。 基础结构：base_dir/user_id/{config, data, cache} """ user_path = os.path.join(base_dir, str(user_id)) sub_dirs = ['config', 'data', 'cache'] # 使用 os.makedirs 创建多级目录，exist_ok 确保已存在时不报错 for sub_dir in sub_dirs: dir_to_create = os.path.join(user_path, sub_dir) os.makedirs(dir_to_create, exist_ok=True) print(f"确保目录存在: {dir_to_create}") # 返回主目录路径供后续使用 return user_path # 使用示例 user_home = setup_user_data_dir('/opt/appdata', 1001) ``` 此示例演示了如何使用 `os.path.join()` 构建清晰、可移植的路径，以及使用 `os.makedirs(..., exist_ok=True)` 实现幂等的目录创建操作，这是编写健壮脚本的关键 [ref_1][ref_6]。 掌握 `os` 和 `os.path` 模块的这些核心函数，能够高效、安全地处理大多数文件系统相关任务。关键在于理解 `os` 负责执行动作（如创建、删除），而 `os.path` 负责处理路径信息（如拼接、判断）[ref_3][ref_4]。在实际编码中，优先使用 `os.path.join()` 进行路径拼接，使用 `os.makedirs()` 创建目录，并使用 `os.path.exists()`、`os.path.isfile()` 等函数在操作前进行检查，可以有效避免常见的路径和文件操作错误。