一、Python/pip 路径未添加到系统环境变量(command not found)
- 解决办法:
- 重新安装 Python,勾选 “Add Python to PATH”(Windows)
- 手动添加路径到环境变量(Linux/macOS:export PATH=$PATH:/usr/local/python3/bin)
- 使用绝对路径调用:/usr/local/bin/python3 -m pip install 包名
二、虚拟环境未激活(包安装到全局环境)
- 解决办法:
- 激活虚拟环境(Windows:venv\Scripts\activate;Linux/macOS:source venv/bin/activate)
- 检查命令行前缀是否有(venv)标识,确认激活状态
- 使用pip -V查看当前 pip 路径,确认指向虚拟环境内的 pip
三、用户权限限制(如公司电脑禁止全局安装)
- 解决办法:
- 使用用户级安装:pip install 包名 –user(包会安装到用户目录,无需管理员权限)
- 手动下载包源码,解压后执行:python setup.py install –user
- 申请临时管理员权限或使用便携版 Python(如Portable Python)
四、安全软件拦截(如 360 误报 “恶意程序”)
- 解决办法:
- 暂时关闭安全软件的实时防护,安装完成后恢复
- 将 Python 安装目录和项目目录添加到安全软件白名单
- 从官方渠道下载包(如 PyPI 官网),避免第三方非可信源
五、磁盘空间不足(No space left on device)
- 解决办法:
- 清理安装目录所在磁盘的冗余文件(如 Windows 的 “磁盘清理”)
- 更换安装路径到空间充足的磁盘(pip install 包名 –target=/新路径)
- 删除虚拟环境中无用的旧包:pip autoremove 无用包
