WSL环境下执行pip3 list等命令无输出重装后仍无效如何解决

步骤1：排查pip源连接超时问题 #

• 首先带调试参数运行pip命令定位卡住的具体环节：
  pip3 list -v
• 绝大多数同类问题由默认PyPI官方源在WSL网络环境下连接受阻导致，先临时替换国内源测试是否正常响应：
  pip3 list -i https://pypi.tuna.tsinghua.edu.cn/simple
  如果执行后正常输出，说明是源配置问题，可按以下方法配置永久国内源：

在用户目录下创建pip配置文件：

mkdir ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

步骤2：排查WSL网络适配问题 #

如果替换源后仍然无响应，检查WSL网络配置：

• 先测试外部网络连通性：
  ping baidu.com -c 3
  如果ping不通，执行以下命令重置WSL网络栈：

sudo rm /etc/resolv.conf
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
sudo bash -c 'echo "[network]" > /etc/wsl.conf'
sudo bash -c 'echo "generateResolvConf = false" >> /etc/wsl.conf'

执行完成后在Windows终端执行wsl --shutdown重启WSL实例后再测试pip命令。

步骤3：排查Python依赖损坏问题 #

如果上述操作都无效，检查系统Python关联的依赖包是否损坏：

• 先卸载系统默认的pip包：
  sudo apt remove --purge python3-pip -y
• 重新安装Python基础依赖：
  sudo apt install python3-dev python3-setuptools -y
• 用官方脚本手动安装pip：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
sudo python3 get-pip.py

补充说明 #

90%以上的同类问题都可以通过上述三个步骤解决，不需要重新安装整个WSL虚拟机，只有当系统基础组件出现大规模损坏时才考虑重置WSL实例。

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