site.getsitepackages() 返回空列表时应合并 site.getusersitepackages() 并过滤 None；sys.path 包含所有导入路径，而 site 模块仅管理站点包路径；验证模块加载需用 importlib.util.find_spec()；使用 site.addsitedir() 前应检查路径存在性。
site.getsitepackages() 返回空列表怎么办
这个函数只在安装了 Python 包管理器（如 pip）且存在已安装第三方包的环境下才返回有效路径，纯标准库环境或虚拟环境未激活时可能为空。实际使用中更推荐 site.getsitepackages() 配合 site.getusersitepackages() 一起查，因为用户级包路径（比如用 pip install --user 安装的）不会出现在前者里。
常见错误是只调用 site.getsitepackages() 就以为找全了，结果漏掉用户目录下的 site-packages。正确做法是合并两者，并过滤掉 None：
import site paths = site.getsitepackages() or [] + [site.getusersitepackages()] or [] paths = [p for p in paths if p]
为什么 sys.path 比 site 模块显示的路径更多
sys.path 是 Python 实际用于模块导入的完整搜索链，包含 site 相关路径、当前工作目录、PYTHONPATH 设置、内置默认路径等。而 site 模块只负责管理“站点包”相关路径（即第三方包安装位置）。
所以要看“所有搜索路径”，必须用 sys.path，不是 site 模块的函数。典型误用是以为 site 能替代 sys.path —— 它不能。
立即学习“Python免费学习笔记（深入）”；
-
sys.path[0]总是当前脚本所在目录（或交互式启动时的当前目录） - 虚拟环境中，
sys.path开头通常是该环境的site-packages，但顺序受python -m、-c、PYTHONPATH影响 - 修改
sys.path是临时的，重启解释器即失效；改PYTHONPATH环境变量才持久
如何验证某个路径是否真被用于 import
光看路径列表没用，得确认 Python 是否真的从那里加载模块。最直接的方法是用 importlib.util.find_spec()：
import importlib.util
spec = importlib.util.find_spec("requests")
print(spec.origin) # 显示实际加载的 .py 或 .so 文件路径如果返回 None，说明模块根本没被找到，哪怕那个路径在 sys.path 里。常见原因包括：
- 路径存在但权限不足（尤其在 Docker 或 rootless 环境）
- 路径里有中文或空格，某些旧版本 Python 解析异常
- 包名拼写错误，或包未正确安装（比如只解压没运行
pip install）
site.addsitedir() 的副作用容易被忽略
这个函数会把指定目录加入 sys.path，并触发该目录下 .pth 文件的解析（类似 pip 安装时的行为）。但它不检查目录是否存在，也不报错 —— 如果路径错了，就静默失败。
调试时建议加个存在性判断：
import os, site
path = "/my/custom/site-packages"
if os.path.isdir(path):
site.addsitedir(path)
else:
print(f"Warning: {path} not found")另外，多次调用 site.addsitedir() 会导致重复路径，虽然不影响 import，但会让 sys.path 变长，排查问题时干扰视线。
