直接修改 sys.path 是最常用且可靠的方式临时增加模块搜索路径，本质是让 Python 解释器在导入时能查到你的模块；推荐用 sys.path.insert(0, str(Path(__file__).parent / "lib").resolve()) 确保路径绝对、优先且跨平台安全。
直接修改 sys.path 是最常用且可靠的方式
临时增加模块搜索路径，本质是让 Python 解释器在导入时能查到你的模块。不推荐改环境变量再重启解释器——太重、不灵活、还容易污染 shell 环境。sys.path 就是 Python 实际使用的搜索路径列表，修改它立竿见影，且仅对当前进程生效。
实操建议：
- 用
sys.path.insert(0, "/your/module/path")插入到最前，确保你的路径优先于标准库和已安装包（避免意外覆盖） - 插入前最好检查路径是否存在且可读：
os.path.isdir()和os.access(path, os.R_OK) - 避免重复插入：可以先
if path not in sys.path:再插入，防止多次运行后路径爆炸 - 注意路径必须是**绝对路径**；相对路径在不同工作目录下行为不可控，
os.path.abspath()保险些
用 pathlib.Path 拼接路径更安全，尤其跨平台
硬写字符串路径（比如 "./mylib" 或 "C:\project\src"）容易出错：斜杠方向、盘符、当前目录偏移都会导致 ImportError。Python 3.4+ 的 pathlib 能自动处理这些细节。
示例：
立即学习“Python免费学习笔记（深入）”；
from pathlib import Path import sys <p>my_module_dir = Path(<strong>file</strong>).parent / "lib" # 相对于当前脚本位置 sys.path.insert(0, str(my_module_dir.resolve()))
关键点：
-
.parent获取脚本所在目录，比os.getcwd()更稳定（后者依赖执行位置） -
.resolve()展开..、符号链接，并转为绝对路径 - 必须用
str()转成字符串再塞进sys.path，因为sys.path只接受字符串
PYTHONPATH 环境变量只在启动时读取，无法“临时”生效
很多人误以为在代码里 os.environ["PYTHONPATH"] = "/xxx" 就能影响后续 import，其实不行。Python 解释器只在**启动瞬间**读取 PYTHONPATH，之后修改环境变量对模块查找完全无效。
常见错误现象：
- 代码里写了
os.environ["PYTHONPATH"] = "/tmp/mylib"，但import mymodule仍报ModuleNotFoundError - 在 shell 中
export PYTHONPATH=/tmp/mylib后直接运行python script.py—— 这确实有效，但属于“启动前设置”，不是“代码中临时增加”
所以，如果目标是“在运行中动态加路径”，sys.path 是唯一正解；PYTHONPATH 只适合部署或调试时一次性配置。
注意 .pth 文件和 site-packages 的隐式加载
如果你把路径加到了 site-packages 下的 .pth 文件里，或者用了 site.addsitedir()，Python 会自动扫描并追加子路径——这看似“临时”，实则有副作用：可能触发 site 模块的额外逻辑（比如自动启用用户站点、禁用 site 等），尤其在虚拟环境中容易干扰原本的包隔离。
除非你明确需要这种机制，否则直接操作 sys.path 更透明、更可控。另外，site.addsitedir() 会递归扫描子目录并添加到 sys.path，如果只是想加一个固定路径，没必要绕这个弯。
复杂点在于：路径顺序、是否真实存在、是否被其他机制（如 zipimport 或 __pycache__ 权限）干扰——这些细节往往在跨机器、CI 环境或容器中才突然暴露。动手前，先打印 sys.path 确认位置和内容，比猜要快得多。
