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）构建时仍依赖它。
- 先升级
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 这类本地开发包也写进去，换机器就失效。
python全能编程助手
下载
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 生产环境优先用
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免费学习笔记（深入）”；
- 查目标机器信息：
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)"，省掉半天排查。 
