'poetry' 不是内部或外部命令,也不是可运行的程序
时间: 2025-07-04 21:20:11 浏览: 16
在 Windows 系统中,当用户尝试运行 `poetry` 命令时,如果系统提示 `'poetry' 不是内部或外部命令,也不是可运行的程序或批处理文件`,这通常意味着 Poetry 未被正确安装或其安装路径未添加到系统的环境变量中。
以下是解决此问题的几种方法:
1. **确认是否已安装 Poetry**
如果尚未安装 Poetry,可以通过官方推荐的方式进行安装。一种常见方式是使用 `get-poetry.py` 脚本安装:
```powershell
(Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -OutFile get-poetry.py).Content
python get-poetry.py
```
此脚本会自动将 Poetry 添加到用户的环境变量中,从而允许在命令行中直接使用 `poetry` 命令 [^3]。
2. **手动将 Poetry 添加到系统环境变量**
如果 Poetry 已经安装,但命令仍无法识别,则需要手动将其安装路径添加到系统环境变量中。具体步骤如下:
- 打开“系统属性”(可通过右键点击“此电脑”或“我的电脑”选择“属性” -> “高级系统设置”)。
- 点击“环境变量”按钮。
- 在“系统变量”部分找到并编辑 `Path` 变量,添加 Poetry 的安装目录(例如 `C:\Users\<用户名>\AppData\Roaming\Python\Scripts`)。
- 单击“确定”保存更改,并重新启动命令行工具以使新设置生效 [^2]。
3. **验证安装和配置**
安装完成后,可以在命令行中输入以下命令来验证 Poetry 是否已经正确安装并可以使用:
```powershell
poetry --version
```
如果一切正常,该命令应该输出 Poetry 的版本号 [^1]。
4. **通过 Python 的 pip 安装 Poetry**
如果上述方法不适用,也可以尝试通过 Python 的包管理器 `pip` 来安装 Poetry:
```powershell
pip install poetry
```
安装完成后,同样需要确保 Poetry 的可执行文件路径已被添加到系统的 `PATH` 环境变量中 [^3]。
5. **检查是否有多个 Python 环境冲突**
在某些情况下,可能会有多个 Python 环境共存于同一台机器上,这可能导致 Poetry 安装到了一个非默认的环境中。在这种情况下,需要确保激活了正确的 Python 环境或者全局安装了 Poetry 。
6. **重新安装 Poetry**
如果以上方法均无效,可以尝试卸载后重新安装 Poetry。首先,删除现有的 Poetry 安装及其相关文件,然后按照官方文档中的指导重新安装 [^3]。
阅读全文
相关推荐

















