Windows环境下Python Poetry安装路径配置问题求助

一、先清理无效的旧配置 #

• 删除移到C:\Program Files下的pypoetry文件夹
• 删除C:\Program Files\Python312\Scripts中的poetry.sym文件
• 从系统PATH中移除之前添加的所有无效路径（比如C:\Program Files\pypoetry这类）
• 删除之前设置的POETRY_HOME系统环境变量

二、离线指定全局目录重新安装Poetry #

你已有本地的install-poetry.py文件，按以下方式操作即可指定全局安装路径：

1. 使用CMD执行（推荐，避开PowerShell语法坑） #

先临时设置安装目录的环境变量，再运行安装脚本：

set POETRY_HOME=C:\Program Files\pypoetry
python D:/Software/install-poetry.py

注意：POETRY_HOME要指向Poetry的安装根目录，不是poetry.exe的路径，安装脚本会自动在该目录下生成venv等子文件夹。

2. 使用PowerShell执行 #

PowerShell设置临时环境变量的语法不同，需这样写：

$env:POETRY_HOME = "C:\Program Files\pypoetry"
python D:/Software/install-poetry.py

三、配置系统PATH #

安装完成后，把Poetry的可执行文件路径添加到系统PATH（而非用户PATH）：

• 需添加的路径：C:\Program Files\pypoetry\venv\Scripts

该路径下包含poetry.exe，添加后重启CMD或PowerShell即可直接调用poetry命令

四、验证安装结果 #

打开新的CMD窗口，执行以下命令：

poetry --version

能正常显示版本号即说明安装成功。

之前操作失效的原因 #

1. 直接剪切pypoetry文件夹：Poetry安装时会在Python的Scripts目录写入关联文件，同时在内部配置中记录原始路径，直接移动会导致所有关联失效，必须重新安装指定路径。
2. CMD语法错误：Windows CMD无法像Linux那样在管道前直接写POETRY_HOME=xxx，必须用set命令先设置环境变量。
3. POETRY_HOME设置错误：该变量指向的是Poetry的安装根目录，而非poetry.exe的具体路径，你之前的设置不符合要求。

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