Windows WSL 2中运行pyenv报错‘cygpath: not found’等问题求助

你当前调用的是Windows系统下的pyenv-win，它依赖Windows/Cygwin专属工具（cygpath、cmd），而WSL 2是Linux环境，无法直接运行Windows版pyenv，需要在WSL内部安装Linux版的pyenv，具体步骤如下：

步骤1：清理WSL中指向Windows pyenv的环境配置 #

检查你的WSL shell配置文件（如~/.bashrc、~/.zshrc），如果存在将Windows侧pyenv路径加入PATH的配置，删除或注释掉。类似这样的行：

export PATH="/mnt/c/Users/USER/.pyenv/pyenv-win/bin:$PATH"

执行命令使配置生效：

source ~/.bashrc  # 若使用bash
# 或
source ~/.zshrc   # 若使用zsh

步骤2：在WSL内部安装Linux版pyenv #

1. 安装编译依赖（以Ubuntu/Debian为例） #

执行命令安装Python编译所需的基础依赖：

sudo apt update
sudo apt install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

2. 克隆pyenv仓库到本地 #

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

3. 配置环境变量 #

将以下内容添加到你的shell配置文件（~/.bashrc或~/.zshrc）末尾：

export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

重新加载配置文件：

source ~/.bashrc  # 或对应shell的配置文件

步骤3：验证安装结果 #

执行以下命令，若能正常输出pyenv版本，说明安装成功：

pyenv --version

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