MacOS下安装Poetry失败，提示无法不使用symlinks创建venv

错误原因 #

你遇到的这个错误核心在于：当前使用的是苹果Command Line Tools自带的定制版Python 3.9，该版本强制要求创建虚拟环境时必须使用符号链接（symlinks），但Poetry默认安装脚本在创建环境时未启用symlinks选项，触发了Python内置venv模块的限制。

并非你“缺失symlinks”，而是这个定制Python版本本身不允许在不使用symlinks的情况下创建虚拟环境，安装脚本未满足该要求才导致报错。

解决办法 #

方法1：切换到官方标准Python版本安装 #

苹果自带的Python常有定制限制，推荐用pyenv安装官方标准Python版本后再安装Poetry：

1. 安装pyenv（未安装时执行）：

   brew install pyenv
   

2. 安装一个标准Python版本（以3.11为例）：

   pyenv install 3.11
   

3. 设置全局使用该版本：

   pyenv global 3.11
   

4. 重新执行Poetry安装命令：

   curl -sSL https://install.python-poetry.org | python3 -
   

方法2：强制安装脚本使用symlinks创建环境 #

通过环境变量让Poetry安装脚本启用symlinks选项：

curl -sSL https://install.python-poetry.org | POETRY_VIRTUALENVS_OPTIONS="--symlinks" python3 -

方法3：手动创建虚拟环境后安装 #

先手动用symlinks创建虚拟环境，再在环境内安装Poetry：

1. 创建虚拟环境：

   python3 -m venv ~/.poetry-env --symlinks
   

2. 激活虚拟环境：

   source ~/.poetry-env/bin/activate
   

3. 用pip安装Poetry：

   pip install poetry
   

4. 将Poetry路径添加到shell配置文件（如~/.zshrc或~/.bashrc）：

   echo 'export PATH="$HOME/.poetry-env/bin:$PATH"' >> ~/.zshrc
   

   刷新配置：

   source ~/.zshrc
   

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