本文详解为何调用 os.path.join() 和 os.mkdir() 后文件仍未生成，并提供基于 pathlib 的简洁、可靠解决方案，包括创建目录结构、初始化空文件及关键注意事项。
本文详解为何调用 `os.path.join()` 和 `os.mkdir()` 后文件仍未生成，并提供基于 `pathlib` 的简洁、可靠解决方案，包括创建目录结构、初始化空文件及关键注意事项。
在 Python 中，仅拼接路径字符串（如 os.path.join(self._dir, "file.txt")）或调用 os.mkdir() 创建目录，并不会自动创建文件——它只是构造了一个路径对象或生成了文件夹。因此，你的代码中 self.checkpoint 只是一个字符串路径，而 file.txt 实际并未写入磁盘，导致后续读取时抛出 FileNotFoundError。
使用现代 Python 推荐的 pathlib 模块可大幅提升路径操作的可读性与健壮性。以下为完整、可直接复用的修复方案：
import tempfile from pathlib import Path # 创建顶层临时目录（返回 Path 对象） self._dir = Path(tempfile.mkdtemp()) # 构建子目录路径并创建（mkdir() 默认不递归，需确保父目录存在） self._dir = self._dir / "test" self._dir.mkdir() # 等价于 os.mkdir(str(self._dir)) # 定义检查点文件路径 self.checkpoint = self._dir / "file.txt" # ✅ 关键步骤：显式创建空文件（若不存在则新建；存在则更新 mtime） self.checkpoint.touch()
? 提示：Path.touch() 不仅创建文件，还支持参数 exist_ok=True（默认启用），避免重复创建时报错；若需写入初始内容，可改用 self.checkpoint.write_text("initial content")。
注意事项与最佳实践：
立即学习“Python免费学习笔记（深入）”；
- ❌ 避免混用 os.path 和 pathlib：一旦启用 Path，应全程使用 / 运算符拼接路径，而非 os.path.join()；
- ✅ 利用 Path.resolve() 在调试时验证路径真实性（如 print(self.checkpoint.resolve())）；
- ⚠️ 临时目录需手动清理：建议在 __del__ 或 tearDown() 中调用 shutil.rmtree(self._dir.parent)，或使用 tempfile.TemporaryDirectory() 上下文管理器实现自动回收；
- ? 若涉及并发或多进程访问，请注意 touch() 非原子操作，高竞争场景下需加锁或改用 open(..., 'x') 模式防止覆盖。
通过 pathlib + touch() 的组合，你不仅能彻底解决“目录存在但文件不见”的问题，还能写出更符合 Python 3.4+ 标准、更易维护的路径处理逻辑。
