WSL2 Ubuntu安装pyenv-win后原有pyenv失效的问题求助

核心原因 #

报错的本质是WSL的bash误执行了Windows端pyenv-win的脚本：

• WSL默认会将Windows的PATH环境变量合并到Ubuntu的环境中
• pyenv-win和Ubuntu的pyenv都会把自身的bin目录加到PATH，如果Windows的路径优先级更高，WSL启动时就会优先调用Windows的pyenv脚本
• Windows脚本使用DOS换行格式（^M是\r换行符），Linux的/bin/sh无法识别，因此抛出"bad interpreter"错误

快速修复方案 #

无需恢复系统或卸载重装pyenv，只需调整WSL的环境变量优先级：

方案1：调整本地pyenv配置的加载顺序 #

1. 打开Ubuntu的bash配置文件：

   nano ~/.bashrc
   

2. 找到原本pyenv的配置段（一般是这三行）：

   export PATH="$HOME/.pyenv/bin:$PATH"
   eval "$(pyenv init -)"
   eval "$(pyenv virtualenv-init -)"
   

3. 将这几行剪切到文件最末尾，确保它在WSL自动挂载Windows PATH的配置之后执行
4. 保存退出后，执行以下命令生效：

   source ~/.bashrc
   

方案2：直接屏蔽Windows的pyenv路径 #

如果方案1无效，可在~/.bashrc末尾添加一行，过滤掉Windows端的pyenv路径：

export PATH=$(echo "$PATH" | tr ':' '\n' | grep -v '/mnt/c/Users/mryan/.pyenv' | tr '\n' ':')

执行source ~/.bashrc生效即可。

验证修复效果 #

执行以下命令，确认pyenv路径指向Ubuntu本地的安装：

which pyenv

正确输出应为：/home/dev/.pyenv/bin/pyenv

关于配置顺序的疑问 #

不需要先卸载Ubuntu的pyenv再安装pyenv-win，两者是完全独立的环境：

• pyenv-win管理Windows系统的Python版本
• WSL的pyenv管理Ubuntu子系统内的Python版本
  只要确保WSL的环境变量优先加载本地pyenv的路径，就不会出现冲突。

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