pip与python版本不一致的根本原因是path路径中pip.exe指向旧环境，而当前python解释器属于新版本，导致pip install装错位置；应统一使用python -m pip命令确保版本匹配。
pip --version 和 python -m pip --version 显示不同 Python 版本
这是最直接的信号：你当前 shell 调用的 pip 和你正在运行的 python 解释器根本不是一对。比如 pip --version 输出 python 3.9，而 python -m pip --version 输出 python 3.11 —— 说明 PATH 里第一个 pip.exe 来自旧环境，但你的终端里激活的是新解释器。
根本原因不是 pip “坏了”，而是 Windows/macOS/Linux 都按 PATH 顺序找可执行文件，不关心它属于谁。你删了旧 Python 目录，但 PATH 没清理，或者 Anaconda、pyenv、Microsoft Store 版 Python 各自往 PATH 插了一条 Scripts 路径，顺序一乱就失控。
- 立刻执行
where pip（Windows）或which pip（macOS/Linux），看列出的所有路径；排第一的那个就是实际生效的pip - 对比
python -c "import sys; print(sys.executable)"，确认你“以为在用”的解释器真实路径 - 如果两者不一致，
pip install必然装错地方 —— 别修 pip，要修调用逻辑
在虚拟环境中 pip install 仍报 ModuleNotFoundError
激活了 venv，python -c "import sys; print(sys.path)" 显示 site-packages 在虚拟环境目录里，但 pip list 却列着系统包，甚至 pip install requests 后 import requests 还失败。这说明你激活了环境，但 pip 命令没跟着切换过去。
venv 的 Scripts/activate 只改了 python 的指向，不保证 pip 也同步。尤其当你用 conda 创建的 env、或 pyenv + venv 混用时，这个断层更常见。
- 绝对不要依赖激活后直接敲
pip install；一律改用python -m pip install - 确保命令前的
python是你刚source activate或.\venv\Scripts\activate后能调用的那个，不是 PATH 里的全局python - 验证方式：执行
python -m pip show requests，输出路径必须和sys.path[0]一致
CI/CD 脚本中 pip 安装包后 runtime 找不到模块
在 GitHub Actions、GitLab CI 或 Jenkins 里，脚本写 pip install numpy 看似成功，但后续 python script.py 就报 ModuleNotFoundError。这是因为 CI runner 的 PATH 里默认 pip 往系统 site-packages 装，而你指定的 Python 解释器（如 /opt/python/3.11/bin/python）却只认自己的 site-packages。
CI 环境通常干净但不可控：PATH 由 runner 预设，你无法修改；不同 step 间环境隔离；pip 可能是系统自带的旧版本。
- 所有安装命令必须显式绑定解释器：
/opt/python/3.11/bin/python -m pip install numpy - 避免用
python -m pip而不指定完整路径——python可能被 runner 重定向到别的版本 - 若用 pyenv，优先用
pyenv exec python3.11 -m pip install，比pyenv shell 3.11 && pip install更可靠
Windows 上 pip 启动报 Fatal error in launcher
典型错误信息：Fatal error in launcher: Unable to create process using '"C:\Old\Path\python.exe" "C:\Old\Path\Scripts\pip.exe" --version'。这不是权限问题，是 pip.exe 启动器硬编码了旧 Python 路径，而那个 python.exe 已被移动、重命名或删除。
这种问题多见于手动迁移 Python 安装目录、用 Microsoft Store 安装后又卸载、或用第三方工具（如 PyCharm 自带 Python）后残留启动器。
- 不要重装 Python；用当前有效的 Python 解释器修复：
C:\New\Path\python.exe -m ensurepip --upgrade - 紧接着升级 pip 本身：
C:\New\Path\python.exe -m pip install --upgrade pip，这会重建正确的启动器 - 检查并清理 PATH：删掉所有指向已不存在目录的
Scripts路径，只保留当前有效 Python 的Scripts和根目录
真正麻烦的从来不是“怎么装包”，而是“装到哪去”。多版本环境下，pip 命令本身就是一个路径幻觉，只有 python -m pip 才是确定性的锚点。别试图让 PATH 保持完美，直接绕过它——把解释器路径写死，才是生产环境里最省心的解法。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
