Hey there! Let me break down exactly how to install pip across different operating systems, and walk you through fixing those common frustrating errors you might run into later.

一、各系统的pip安装步骤 #

1. Windows 系统 #

• First off, check if Python is already installed: Open Command Prompt (CMD) and run python --version or py --version. If you see a version number pop up, Python’s already on your system—and pip is usually included by default.
• If pip’s missing or you need to update it:
  • Run py -m ensurepip --upgrade in CMD. This command will automatically install pip (if it’s not there) or update it to the latest version.
  • Verify it worked: Type pip --version—you should see the current pip version displayed.

2. macOS & Linux 系统 #

• Most Linux distros (like Ubuntu, Debian) come with Python pre-installed, but pip might be missing:
  • Ubuntu/Debian: Open your terminal and run sudo apt update && sudo apt install python3-pip
  • Fedora/RHEL: Use sudo dnf install python3-pip
• macOS: If you’re using the system’s default Python, first install Xcode Command Line Tools with xcode-select --install, then run python3 -m ensurepip --upgrade to set up pip.
• Verify installation: In terminal, type pip3 --version (since these systems typically default to Python 3, pip is named pip3).

二、常见pip报错及快速解决办法 #

1. 权限错误（Permission denied） #

典型报错：PermissionError: [Errno 13] Permission denied: '/usr/local/lib/python3.x/site-packages/xxx'

• Why this happens: You don’t have permission to modify system-level Python package directories.
• Fixes:
  • Recommended (safer): Use a virtual environment. First create one: python3 -m venv myenv
    • Activate it on Windows: myenv\Scripts\activate
    • Activate it on macOS/Linux: source myenv/bin/activate
      Once activated, installing packages with pip won’t trigger permission issues.
  • Temporary fix (not recommended for system-wide use): Add the --user flag to install packages to your user directory: pip install --user package-name

2. 网络连接失败（Connection timeout/SSL errors） #

典型报错：Could not fetch URL https://pypi.org/simple/xxx/: There was a problem confirming the ssl certificate...

• Why this happens: Unstable internet, or your connection is blocked by a firewall/proxy.
• Fixes:
  • Use a domestic PyPI mirror (faster and more reliable in some regions): pip install package-name -i https://mirrors.aliyun.com/pypi/simple/
  • If you’re behind a proxy:
    • Temporary fix: Run pip install package-name --proxy=http://your-proxy-address:port
    • Permanent fix: Create a pip config file—on Windows it’s %APPDATA%\pip\pip.ini, on macOS/Linux it’s ~/.config/pip/pip.conf—and add these lines:

      [global]
      index-url = https://mirrors.aliyun.com/pypi/simple/
      proxy = http://your-proxy-address:port
      

3. 版本冲突错误（Version conflict） #

典型报错：ERROR: Cannot install package-name because these conflicting requirements exist...

• Why this happens: The package you’re trying to install clashes with an already installed package’s version requirements.
• Fixes:
  • Install a specific version of the package that’s compatible: pip install package-name==1.2.3 (replace 1.2.3 with the version you need)
  • Try upgrading the conflicting package: pip install --upgrade conflicting-package-name (note: this might break other dependencies, so proceed carefully)
  • Run pip check to scan your environment for existing dependency conflicts before installing new packages.

4. 旧版pip导致的安装失败 #

典型报错：ERROR: Could not find a version that satisfies the requirement package-name (from versions: none)

• Why this happens: Older pip versions don’t support the latest PyPI index formats or new package versions.
• Fix: Update pip to the latest version:
  • Windows: py -m pip install --upgrade pip
  • macOS/Linux: pip3 install --upgrade pip

内容的提问来源于stack exchange，提问作者Arghya Haldar