Python contextlib.chdir 临时切换工作目录：异常恢复、嵌套调用与并发边界

批处理脚本需要读取固定文件夹下的模板、清单或数据文件时，很容易留下一个隐蔽问题：函数为了调用旧代码临时修改了进程当前工作目录，异常发生后后续任务还会继续在错误目录里运行。Python 的 contextlib.chdir 可以把这段临时切换逻辑收进 with 块，不管是正常退出还是抛出异常，都会自动恢复成切换前的目录。

把 contextlib.chdir 限定在短小、线性的文件操作块里；只要代码会并发运行、跨线程共享，或者可以直接传入 Path，就优先使用显式路径，避免修改进程级 cwd。

先把一次目录切换变成可验收的小任务

下面的批处理逻辑会在项目目录中读取 manifest.json。验收标准不是“代码能跑完”，而是进入上下文前的 cwd、块运行时的 cwd、退出上下文后的 cwd 都能被正常打印校验。

from contextlib import chdir
from pathlib import Path

project = Path("demo-project").resolve()
before = Path.cwd()

with chdir(project):
    print("inside:", Path.cwd())
    print(Path("manifest.json").read_text(encoding="utf-8"))

assert Path.cwd() == before
print("restored:", Path.cwd())

chdir 接受路径对象或者可以转成路径的普通字符串值。把目标目录先解析成绝对路径，能减少调用者从不同启动目录运行脚本时的歧义；加上目录恢复的断言，能把这个逻辑变成可测试的一部分。

异常发生时，恢复动作仍然要成立

文件处理流程经常在读取、解析或校验阶段抛出异常。手写 os.chdir 加 try/finally 很容易在多层函数调用里遗漏目录恢复的逻辑；上下文管理器可以把恢复动作自动绑定到所有退出路径上。

from contextlib import chdir
from pathlib import Path

root = Path("fixtures").resolve()
original = Path.cwd()

try:
    with chdir(root):
        raise ValueError("invalid manifest")
except ValueError as error:
    print("handled:", error)

assert Path.cwd() == original

这里的 except 只负责业务层处理异常，目录恢复动作完全由 with 的退出流程完成。如果最后校验恢复后的路径不对，优先检查是不是有更外层的代码修改了全局 cwd，不要给当前上下文块再加一层额外的切换逻辑。

嵌套调用为什么能恢复到正确层级

批处理器可能先进入项目根目录，再调用一个需要进入 fixtures 的校验函数。每个 with chdir(...) 都会保存自己进入时的目录快照，内层退出时回到项目根目录，外层退出时回到脚本启动目录。

from contextlib import chdir
from pathlib import Path

root = Path("demo-project").resolve()
fixtures = root / "fixtures"
start = Path.cwd()

with chdir(root):
    assert Path.cwd() == root
    with chdir(fixtures):
        assert Path.cwd() == fixtures
    assert Path.cwd() == root

assert Path.cwd() == start

嵌套切换只适合很短的同步代码段。把目录切换藏在通用工具函数里，会让调用者很难判断相对路径究竟基于哪一层目录解析；实际项目里要在函数名或参数里明确标注这个切换目录的副作用。

什么时候应该放弃 chdir，直接传 Path

尤其要注意，cwd 不是线程本地变量。一个线程在 with chdir() 内运行时，其他线程也能观察到新切换的目录。异步代码同样可能在 await 之后让出执行权，因此不要把目录切换逻辑包住含有等待点的代码。

给旧版本和测试环境留出清晰边界

如果项目需要支持没有 contextlib.chdir 的旧版 Python，可以自己写一个小型兼容上下文管理器兜底，但新写的代码仍应优先传递绝对路径。测试时覆盖正常退出、异常退出和嵌套退出三条路径，能很快发现隐式 cwd 泄漏的问题。

try:
    from contextlib import chdir
except ImportError:
    from contextlib import contextmanager
    import os

    @contextmanager
    def chdir(path):
        previous = os.getcwd()
        os.chdir(path)
        try:
            yield
        finally:
            os.chdir(previous)

兼容代码只能补齐接口功能，不会改变 cwd 属于进程级共享状态这个特性。把兼容逻辑单独放在适配模块中，并且在项目文档里标注“不可用于并发任务”，比在业务代码里到处复制重复逻辑更容易维护。

常见问题

contextlib.chdir 会自动创建目标目录吗？

不会。目标路径不存在时，进入上下文的瞬间就会抛出文件系统异常；需要创建目录时要在切换前显式完成，同时提前检查好对应权限。

with 代码块里抛异常，目录一定会恢复吗？

正常的上下文退出都会执行恢复逻辑，包括异常退出场景；如果进程被系统强制终止，则不能依赖上下文的清理代码执行。

可以在 asyncio 任务里使用 chdir 吗？

不建议。任务切换期间其他协程可能读到临时修改的 cwd，异步函数更适合接收绝对路径或者项目根目录参数传入。

为什么测试里还会出现相对路径错乱？

检查测试夹具、线程和第三方库是否在当前上下文外修改了 cwd，并且为每个测试用例记录进入前后的 Path.cwd() 状态。

把 cwd 副作用关进最小边界

contextlib.chdir 很适合迁移只接受相对路径的旧脚本：用短小的 with 块包住文件操作逻辑，异常和嵌套退出场景都能回到原目录。新写的库接口则应该把路径当作普通参数传递，尤其不要让并发任务共享一次临时目录切换操作。