如何解决pip安装包时的OSError：缺少SOCKS支持依赖问题

以下是针对该报错的详细修复步骤：

1. 安装SOCKS依赖库 #

如果环境需要通过SOCKS代理连接PyPI，先安装对应依赖包：

• 激活虚拟环境后执行：

  pip install pysocks
  

• 若为Linux系统，也可通过系统包管理器安装（以Python3为例）：
  • Debian/Ubuntu：

    sudo apt-get install python3-socks
    

  • CentOS/RHEL：

    sudo yum install python3-socks
    

2. 临时禁用不必要的SOCKS代理设置 #

若不需要代理却触发报错，可能是环境存在残留代理配置：

• Linux/macOS终端执行以下命令清空代理环境变量：

  unset http_proxy https_proxy all_proxy
  

• Windows命令行执行：

  set http_proxy=
  set https_proxy=
  set all_proxy=
  

  之后再尝试pip install <package_name>。

3. 强制pip跳过代理连接 #

执行安装命令时添加--no-proxy参数，强制pip直接连接PyPI：

pip install <package_name> --no-proxy

4. 配置正确的SOCKS代理（若确实需要） #

必须使用SOCKS代理时，确保pysocks安装完成后，可通过两种方式配置：

• 环境变量方式：

  export all_proxy=socks5://你的代理地址:端口号
  

• pip配置文件方式：
  • Linux/macOS：创建或修改~/.config/pip/pip.conf，添加内容：

    [global]
    proxy = socks5://你的代理地址:端口号
    

  • Windows：创建或修改%APPDATA%\pip\pip.ini，添加上述相同内容。

内容的提问来源于stack exchange，提问作者John Lincoln