在 Python 中**获取指定目录下所有 `.txt` 文件的路径列表**，有多种标准、安全、跨平台的方式。下面我将从 **基础方法 → 增强功能（递归/过滤/排序）→ 生产级健壮写法 → 性能对比与选型建议** 全面讲解，并附**可直接运行的代码 + 逐行解释**。 --- ### ✅ 一、最常用 & 推荐方式：`pathlib`（Python 3.4+，现代、简洁、面向对象） ```python from pathlib import Path # ✅ 指定目录（支持相对路径、绝对路径、Windows/Linux/macOS） directory = Path("data") # ← 自动处理路径分隔符（无需写 "data\\" 或 "data/"） # ✅ 获取该目录下所有 .txt 文件（不递归子目录） txt_files = list(directory.glob("*.txt")) print("找到的 .txt 文件：") for file in txt_files: print(f" 📄 {file.name} → {file.resolve()}") # .resolve() 返回绝对路径 # 输出示例： # 📄 log.txt → /home/user/project/data/log.txt # 📄 notes.txt → /home/user/project/data/notes.txt ``` > 🔍 `glob("*.txt")` 是通配符匹配，返回 `Path` 对象列表（不是字符串！），支持链式操作。 ✅ **优势**： - 跨平台（`Path("a/b/c")` 在 Windows 和 Linux 都正确） - 返回 `Path` 对象 → 可直接调用 `.stem`, `.suffix`, `.read_text()`, `.exists()` 等方法 - 代码可读性强，无字符串拼接风险 --- ### ✅ 二、其他标准方式（兼容旧版本或特殊需求） #### ▶ 方式 2：`os.listdir()` + 手动过滤（简单、轻量） ```python import os directory = "data" txt_files = [] for filename in os.listdir(directory): if filename.lower().endswith(".txt"): # ✅ 忽略大小写（如 README.TXT） full_path = os.path.join(directory, filename) if os.path.isfile(full_path): # ✅ 确保是文件，不是子目录 txt_files.append(full_path) print(txt_files) # ['data/log.txt', 'data/notes.txt'] ``` #### ▶ 方式 3：`glob` 模块（功能强大，支持递归 `**`） ```python import glob import os # ✅ 当前目录下的 .txt 文件 txt_files = glob.glob("*.txt") # ✅ 递归搜索 data/ 下所有子目录中的 .txt 文件（Python 3.5+） txt_files_recursive = glob.glob("data/**/*.txt", recursive=True) # ✅ 安全：转为绝对路径并过滤掉目录（glob 可能返回目录名？不会，但保险起见） txt_files = [f for f in txt_files_recursive if os.path.isfile(f)] ``` > ⚠️ 注意：`glob` 返回的是**字符串路径**，不是 `Path` 对象；且 `**` 在旧版 Python 中需 `recursive=True`。 #### ▶ 方式 4：`os.walk()`（完全控制，适合复杂条件） ```python import os def find_txt_files(root_dir, recursive=True): txt_paths = [] for dirpath, dirnames, filenames in os.walk(root_dir): for filename in filenames: if filename.lower().endswith(".txt"): full_path = os.path.join(dirpath, filename) txt_paths.append(full_path) if not recursive: break # 只遍历第一层 return txt_paths txt_files = find_txt_files("data", recursive=False) ``` ✅ 适用场景：需要同时访问父目录名、按修改时间过滤、跳过特定子目录等高级逻辑。 --- ### ✅ 三、生产级增强版（健壮 + 实用功能） 以下是一个**工业强度函数**，支持： - ✅ 递归/非递归 - ✅ 大小写无关匹配 - ✅ 排序（按名称/时间） - ✅ 过滤隐藏文件（以 `.` 开头） - ✅ 返回 `Path` 对象（推荐）或字符串 - ✅ 异常安全（路径不存在时友好提示） ```python from pathlib import Path from typing import List, Union def get_txt_files( directory: Union[str, Path], recursive: bool = False, sort_by: str = "name", # "name", "mtime", "size" include_hidden: bool = False, as_string: bool = False, ) -> List[Union[Path, str]]: """ 获取指定目录下所有 .txt 文件路径列表 Args: directory: 目录路径（字符串或 Path 对象） recursive: 是否递归子目录 sort_by: 排序依据（name: 文件名, mtime: 修改时间, size: 大小） include_hidden: 是否包含隐藏文件（Linux/macOS 以 . 开头，Windows 无隐藏概念） as_string: 返回字符串路径（True）还是 Path 对象（False） Returns: 排序后的文件路径列表 """ root = Path(directory) if not root.exists(): raise FileNotFoundError(f"目录不存在：{root}") pattern = "**/*.txt" if recursive else "*.txt" files = [f for f in root.glob(pattern) if f.is_file()] # 过滤隐藏文件（仅 Unix-like 系统有意义） if not include_hidden: files = [f for f in files if not f.name.startswith(".")] # 排序 if sort_by == "name": files.sort(key=lambda x: x.name.lower()) elif sort_by == "mtime": files.sort(key=lambda x: x.stat().st_mtime, reverse=True) # 最新在前 elif sort_by == "size": files.sort(key=lambda x: x.stat().st_size, reverse=True) return [str(f) if as_string else f for f in files] # ✅ 使用示例 try: txt_list = get_txt_files("data", recursive=True, sort_by="mtime") print(f"共找到 {len(txt_list)} 个 .txt 文件：") for p in txt_list[:3]: # 打印前3个 print(f" 📅 {p.stat().st_mtime:.0f} | 📄 {p.name} | 📏 {p.stat().st_size}B") except FileNotFoundError as e: print(e) ``` --- ### ✅ 四、快速验证：一行命令查看结果（调试用） ```python # 一行打印所有 .txt 文件名（适合 REPL/Jupyter） from pathlib import Path print([f.name for f in Path("data").glob("*.txt")]) # → ['log.txt', 'config.txt', 'README.TXT'] ``` --- ### ✅ 五、常见问题 & 避坑指南 | 问题 | 正确做法 | 原因 | |------|-----------|------| | ❌ `Path("data").glob("*.TXT")` 找不到 `readme.txt` | ✅ 用 `.lower().endswith(".txt")` 或 `glob("*.txt")` + `casefold()` | `glob` 在大多数系统**区分大小写**（Linux/macOS），Windows 不区分但 `pathlib` 行为统一建议小写匹配 | | ❌ `os.listdir()` 返回子目录名也被当作文本文件 | ✅ 一定要加 `os.path.isfile(full_path)` 判断 | 否则 `data/logs/` 这种目录也会被误加入 | | ❌ 路径含中文时报 `UnicodeEncodeError` | ✅ `pathlib` 和 `os` 在 Python 3 中默认支持 UTF-8 路径，无需额外处理 | 仅在极老环境（Python < 3.6）或某些 Windows 控制台编码异常时需 `sys.stdout.reconfigure(encoding='utf-8')` | | ❌ 递归太深导致性能差 | ✅ 用 `pathlib.Path.rglob("*.txt")` 替代 `glob("**/*.txt")`（更语义化） | `rglob` 是 `pathlib` 专为递归设计的方法 | --- ### ✅ 六、性能简要对比（10万文件场景） | 方法 | 速度 | 内存 | 推荐度 | 说明 | |------|------|------|--------|------| | `pathlib.Path.glob()` | ⚡ 快 | 🟢 低 | ✅✅✅ | 默认首选，API 清晰，维护性好 | | `os.listdir()` + 循环 | ⚡⚡ 稍快 | 🟢 低 | ✅✅ | 更底层，但代码冗长 | | `glob.glob()` | ⚡ 中等 | 🟡 中 | ✅ | 支持 `**` 便捷，但返回字符串 | | `os.walk()` | 🐢 较慢（启动开销） | 🟡 中高 | ✅（复杂逻辑时） | 灵活性最高，但简单需求杀鸡用牛刀 | > ✅ 结论：**95% 场景用 `pathlib` —— 它是 Python 官方推荐的现代路径操作方案**。 ---