pip install 仍装到全局或旧环境是因为未真正激活目标虚拟环境，需通过 python -c "import sys; print(sys.prefix)" 确认路径，避免复制 .venv、使用不兼容 python 版本或错误下载 whl 包。

pip install 仍装到全局或旧环境？检查激活状态和路径

根本不是 pip 本身坏了，而是你没真正在目标虚拟环境中执行命令。常见现象是：终端显示 (.venv)，但 pip install requests 后 pip show requests 显示路径在别的项目里，或者 which pip（Linux/macOS）/ where pip（Windows）输出的不是当前目录下的 .venv/bin/pip 或 .venv\Scripts\pip.exe。

• 先运行 python -c "import sys; print(sys.prefix)"，确认输出的是当前项目的 .venv 路径，不是系统 Python 路径
• Windows 上若用 PowerShell 激活失败，别硬改策略；直接切 CMD 运行 .venv\Scripts\activate.bat，或用 Git Bash 运行 source .venv/Scripts/activate
• 绝对不要复制整个 .venv 文件夹到新项目——所有脚本里的路径都是硬编码的，复制等于白忙

pip install -r requirements.txt 报错 ModuleNotFoundError: No module named 'distutils'

这通常出现在 Python ≥3.12 的虚拟环境中，因为 distutils 已被彻底移除，而某些老包（如旧版 setuptools、numpy 或 scipy）构建时仍依赖它。

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

• 先升级 pip 和 setuptools：python -m pip install --upgrade pip setuptools wheel
• 如果仍报错，说明你用的 Python 版本太高（比如 3.13），而项目依赖不兼容；改用 Python 3.9–3.11 创建环境：python3.11 -m venv .venv
• 避免手动安装 distutils——它已不存在于标准库，强行装第三方 backport 可能引发更多冲突

requirements.txt 生成后 install 不生效？验证依赖来源是否可靠

pip freeze > requirements.txt 看似方便，但会把 -e git+https://... 或 -e /abs/path/to/local/pkg 这类本地开发包也写进去，换机器就失效。

• 生产环境优先用 pipreqs . --ignore=tests,venv（需先 pip install pipreqs），它只扫描 import 语句，生成最小可行依赖集
• 若项目含本地包，用 pip install -e ./src/mypackage 安装后，pipreqs 无法识别；此时应在 requirements.txt 中显式写出该包名，并确保 CI/CD 环境能访问对应源码路径
• 安装前务必确认已激活目标环境，且 pip list 是空的或仅含 pip/setuptools ——否则说明环境没切对

离线环境装不上包？whl 包下载参数必须匹配

离线安装失败，90% 是因为 pip download 时平台或 Python 版本标签错了，导致下载的 .whl 在目标机器上不兼容。

• 查目标机器信息：python -c "import platform; print(platform.machine(), platform.system())"（如 'AMD64' 'Windows'）
• 下载时严格指定：pip download numpy --only-binary=:all: --platform win_amd64 --python-version 311 -i https://pypi.tuna.tsinghua.edu.cn/simple
• 安装时禁用网络并指向本地：pip install --no-index --find-links=. -r requirements.txt，且 requirements.txt 中只写包名，不带路径

真实项目里最常卡住的点，不是命令不会敲，而是以为“激活了”就万事大吉——其实 python 命令可能还是系统的，pip 可能还在调旧环境，甚至 IDE 里选的解释器根本没同步更新。动手前多一句 python -c "import sys; print(sys.executable)"，省掉半天排查。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！