WSL2虚拟环境中pip命令执行耗时过长的原因及解决办法咨询

问题背景 #

在WSL2环境下执行pip相关命令时出现异常长耗时，具体现象：

• 处于虚拟环境（venv）时：python -V仅耗时0.013秒，但pip -V耗时长达32秒：

(venv) root@mohsen:/mnt/c# time python -V
Python 3.11.6

real    0m0.013s
user    0m0.007s
sys     0m0.000s
(venv) root@mohsen:/mnt/c# time pip -V
pip 23.2.1 from /mnt/c/project/venv/lib/python3.11/site-packages/pip (python 3.11)

real    0m32.380s
user    0m2.007s
sys     0m4.177s

• 退出venv虚拟环境时：pip -V耗时降至2秒，但仍远高于正常水平：

root@mohsen:/mnt/c# time python -V
Python 3.11.6

real    0m0.278s
user    0m0.206s
sys     0m0.112s
root@mohsen:/mnt/c# time pip -V
pip 23.2.1 from /root/.asdf/installs/python/3.11.6/lib/python3.11/site-packages/pip (python 3.11)

real    0m2.012s
user    0m1.360s
sys     0m0.439s

核心原因 #

• 虚拟环境位于Windows挂载分区：你的venv创建在/mnt/c/project下，WSL2访问Windows NTFS文件系统的IO性能远低于原生Linux文件系统。pip启动时需要读取大量元数据文件（如site-packages中的包信息、配置文件），跨系统挂载的IO延迟会被大幅放大，这是32秒超长耗时的主要原因。
• pip默认版本检查：pip启动时会自动发起网络请求检查新版本，WSL2的网络配置可能导致该请求延迟，这也是退出venv后仍有2秒耗时的原因之一。

可行解决办法 #

1. 将虚拟环境迁移到WSL原生文件系统 #

把venv放在WSL自己的目录（如/home/mohsen/project），彻底避开Windows文件系统的IO瓶颈：

# 退出当前虚拟环境
deactivate
# 复制现有venv到WSL本地目录（也可以直接重新创建）
cp -r /mnt/c/project/venv /home/mohsen/project/
# 激活迁移后的虚拟环境
source /home/mohsen/project/venv/bin/activate

迁移后pip命令的耗时会恢复到正常的毫秒级。

2. 禁用pip版本检查 #

关闭pip启动时的自动版本检查，消除不必要的网络延迟：

# 全局配置（对所有Python环境生效）
pip config set global.disable-pip-version-check true
# 仅对当前虚拟环境生效
pip config --venv set global.disable-pip-version-check true

3. 优化WSL2挂载Windows分区的性能（可选） #

如果必须在Windows目录下运行项目，可修改WSL配置提升IO性能：

1. 在Windows用户目录下创建.wslconfig文件（路径示例：C:\Users\你的用户名\.wslconfig）
2. 添加以下配置内容：

[wsl2]
options="metadata,case=off,umask=0000"

3. 重启WSL使配置生效：

# 在Windows命令提示符或PowerShell中执行
wsl --shutdown

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