定位模块加载路径应先打印sys.path确认顺序，再用module.__file__查看实际加载位置，注意当前目录默认排在首位且虚拟环境可能未真正激活。
模块导入时加载了错误版本，怎么定位是哪个路径在起作用
Python 导入模块时按 sys.path 从左到右扫描，第一个匹配的就用，不会继续往后找。所以你 import requests 成功，不等于你用的是你 pip install 的那个 —— 很可能来自 /usr/lib/python3.9/site-packages 或当前目录下的同名文件。
实操建议：
- 在出问题的脚本开头立刻加
import sys; print('\n'.join(sys.path))，确认路径顺序 - 用
import requests; print(requests.__file__)直接看它实际加载自哪——这是最可靠的方式 - 注意当前工作目录（
os.getcwd()）默认排在sys.path[0]，哪怕没写.也会自动插入，容易被忽略 - 虚拟环境激活后，
sys.path前几项应包含该环境的site-packages和lib/python3.x，否则说明没真正激活
为什么 PYTHONPATH 设置了却没生效
PYTHONPATH 是环境变量，但它只影响 Python 启动时初始化 sys.path 的过程，且优先级低于 -c、-m 等启动方式的隐式路径，也低于 site-packages 的自动注入逻辑。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
- 在 shell 中
export PYTHONPATH=/my/lib后运行python myscript.py，但myscript.py里import mymod仍报错 —— 可能因为mymod.py不在/my/lib下，或文件权限/命名不符合模块规则（如含破折号） - 用 IDE（如 VS Code）运行时，
PYTHONPATH不继承 shell 环境，需在launch.json或设置里显式配置env -
PYTHONPATH路径末尾带斜杠或不带斜杠不影响识别，但路径本身必须存在且可读，否则静默跳过
venv 和 conda 环境下 sys.path 差异在哪
两者都修改 sys.path，但机制不同：venv 通过修改 python 可执行文件的硬链接和 pyvenv.cfg 驱动路径重写；conda 则靠 conda activate 注入一堆 site-packages 和 dist-packages 路径，并可能 patch site 模块行为。
关键差异点：
- venv 的
sys.path[0]是空字符串（代表当前目录），之后才是venv/lib/python3.x/site-packages；conda 默认把envs/myenv/lib/python3.x/site-packages插在更前面，有时还多出conda-meta相关路径 - conda 环境可能启用
conda-forge渠道安装的包，其__file__路径里含conda-forge字样，和 pypi 官方包行为略有差异（比如某些 C 扩展的 ABI 兼容性） - 混用
pip install和conda install在同一环境里，容易导致sys.path中出现多个同名包路径，后者未必覆盖前者 —— 因为路径顺序决定胜负，不是安装时间
如何安全地临时修改 sys.path 而不污染全局
直接改 sys.path.append() 或 insert() 是最常用手段，但风险在于：一旦路径加入，后续所有 import 都会受其影响，包括第三方库内部的导入；而且无法“撤销”，除非手动 remove() 或重建解释器。
更稳妥的做法：
- 只在模块顶层、且明确知道后续只会导入特定子模块时使用，例如：
sys.path.insert(0, './legacy_lib')然后立刻import old_util，之后不再依赖该路径 - 避免在
__init__.py或公共工具函数里动态改sys.path，这会让调用者难以预测导入行为 - 想隔离路径？用子进程：
subprocess.run([sys.executable, '-c', 'import mymod; print(mymod.__file__)'], env={**os.environ, 'PYTHONPATH': '/tmp/test'}) - 调试阶段可用
python -v -c "import requests"查看完整导入轨迹，每行import都会打印尝试路径，比手动查sys.path更直观
真正麻烦的不是路径加得对不对，而是多个地方（.pth 文件、sitecustomize.py、IDE 运行配置、shell 环境、甚至 setuptools 的 egg-link）都在悄悄改 sys.path，它们叠加后的最终顺序，往往连你自己都记不清。
