直接修改 sys.path 是最稳妥的做法：import 机制依赖该列表，需用 insert(0, path) 或 append(path) 添加绝对路径，改 PYTHONPATH 对当前进程无效，仅影响子进程；模块已导入时需先清理 sys.modules 才能重载。
直接修改 sys.path 是最稳妥的做法
Python 脚本运行时改 PYTHONPATH 环境变量本身几乎没用——import 机制在启动时已读取并缓存 sys.path，后续改 os.environ['PYTHONPATH'] 不会自动同步到 sys.path。真正起作用的是 sys.path 这个列表。
实操建议：
- 用
sys.path.insert(0, '/your/module/path')把路径加到最前（优先级最高） - 用
sys.path.append('/your/module/path')加到末尾（优先级最低） - 改完后可立即
import，无需重启解释器 - 注意路径必须是绝对路径，相对路径容易因工作目录变化失效；可用
os.path.abspath()或pathlib.Path(__file__).parent / 'lib'构造
为什么不要碰 os.environ['PYTHONPATH']
改了它不会触发 Python 重新扫描模块路径，新子进程（比如 subprocess.run() 启动的 Python 子进程）才可能继承这个环境变量，但当前进程的 import 完全无视它。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
-
os.environ['PYTHONPATH'] = '/my/lib'; import mymodule→ 报ModuleNotFoundError - 误以为改了环境变量就能“热加载”第三方包路径
- 在 Jupyter 中反复执行
os.environ修改，却没清空sys.modules导致旧模块仍被复用
需要影响子进程时才设置 os.environ['PYTHONPATH']
如果你的脚本要调用另一个 Python 脚本（例如用 subprocess.run(['python', 'other.py'])），且希望那个脚本能 import 到你本地的模块，这时才需要提前设置 os.environ['PYTHONPATH']。
实操建议：
- 务必在
subprocess调用前设置：os.environ['PYTHONPATH'] = os.pathsep.join([new_path] + os.environ.get('PYTHONPATH', '').split(os.pathsep)) - 更干净的做法是显式传入
env=参数，避免污染全局环境：subprocess.run(..., env={**os.environ, 'PYTHONPATH': new_path}) - 注意 Windows 和 Linux 的路径分隔符差异：
os.pathsep会自动处理（';'或':'）
模块已导入后动态换路径？小心缓存陷阱
如果目标模块已经 import 过，光改 sys.path 没用——Python 会直接从 sys.modules 返回已有对象。想“重载”得手动清理。
关键点：
- 先删
sys.modules中对应键：sys.modules.pop('mymodule', None) - 再确保
sys.path已更新到新路径 - 最后
import mymodule才会走新路径重新加载 - 但注意：已存在的对象引用、类实例、全局状态不会自动更新，这不是热更新，而是重建模块对象
这种操作容易引发隐性 bug，除非调试或插件系统，否则不推荐在生产逻辑里做。
