在 Windows 系统中安装 Poetry 非常简单

背太阳的牧羊人

于 2025-04-15 10:09:10 发布

阅读量1k

点赞数 27

分类专栏： python 文章标签：人工智能 python poetry

本文链接：https://blog.csdn.net/u013565133/article/details/147240370

版权

python 专栏收录该内容

139 篇文章

订阅专栏

在 Windows 系统中安装 Poetry 非常简单，下面我一步一步带你完成安装，适合初学者操作。

✅ 一、安装 Poetry（Windows 专用）

✅ 二、设置环境变量（安装完后，可能需要配置）

默认安装路径（Windows）：

C:\Users\你的用户名\AppData\Roaming\Python\Scripts

这个路径下会有一个 poetry.exe，需要把它加入系统的 PATH 环境变量。

添加方式如下（图形界面）：

打开“系统环境变量”设置：
- Win + S 搜索“环境变量”，点击“编辑系统环境变量”
在“系统属性”窗口中点击右下角“环境变量”
找到“Path”变量 → 双击 → “新建”

添加路径：

C:\Users\你的用户名\AppData\Roaming\Python\Scripts

确认 → 保存 → 重启 PowerShell

然后测试：

poetry --version

如果成功，就会输出版本号，比如：

Poetry (version 1.8.2)

✅ 三、初始化一个项目测试一下

poetry new my-demo-project
cd my-demo-project
poetry install
poetry shell

你就进入了项目的虚拟环境了！

🧪 如果你电脑有多个 Python 版本……

你可以指定安装路径的 Python 版本，比如：

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -3.10 -

或者安装之后配置默认使用某个 Python：

poetry env use C:\路径\到\python.exe

❓遇到问题怎么办？

常见问题 & 解决办法：

问题	解决方式
`poetry` 不是内部或外部命令	没配置环境变量，检查 `Scripts` 路径是否加入 Path
无法联网安装	尝试用 VPN 或手动下载脚本后运行
Python 没有装	先从 python.org 安装最新版，并勾选“Add to PATH”

🎁 补充建议（Poetry+VSCode）

如果你用 VSCode 编码，建议：

安装 VSCode 插件：Python、Pylance
进入项目后执行：
```
poetry shell
```
打开 .venv/Scripts/python.exe 为当前解释器（或 VSCode 自动识别）

✅ 安装完成后使用建议

poetry new myproject        # 创建新项目
cd myproject
poetry add requests         # 添加依赖
poetry run python xxx.py    # 用虚拟环境运行程序

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

这个命令是用于 在 Windows 上通过 PowerShell 安装 Poetry 的，一整句看起来有点吓人，但其实拆开之后很简单。

🧠 整体作用：

它的作用是：从官方服务器下载 Poetry 安装脚本，然后立刻用 Python 执行这个脚本进行安装。

🛠️ 拆解讲解每一部分：

✅ 第一步：

Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing

作用：下载网页内容（也就是安装脚本）

Invoke-WebRequest：PowerShell 的命令，用于发起 HTTP 请求（有点像浏览器访问网页）
-Uri https://install.python-poetry.org：指定网址，下载 Poetry 官方的安装脚本
-UseBasicParsing：让 PowerShell 简化网页解析（避免在某些老系统中报错）

比喻：你用 PowerShell 上网，访问 Poetry 安装的官方网页，并把里面的内容抓下来。

这一步的结果是：获取到一个 Python 安装脚本的文本内容（.py 脚本）

✅ 第二步：

(...).Content

.Content：表示“只提取网页的内容部分”，也就是那个 Python 脚本的代码。

✅ 第三步：

| python -

|：管道符，表示把前面的内容“接力”传给后面的命令
python -：告诉 Python“从标准输入读取代码并执行”

比喻：你像是在从网上复制了一段代码，然后贴进 Python 里立刻执行。

🧪 直白一点总结：

这条命令的行为，相当于你手动做以下几步：

打开浏览器，访问：https://install.python-poetry.org
把网页里的一段 Python 安装脚本代码复制出来
打开 Python，粘贴那段代码并运行

而现在这条命令帮你一次性自动完成所有步骤。

🔁 对照 pip 安装方式举例说明：

假如你看到有人说：

curl https://bootstrap.pypa.io/get-pip.py | python

这和安装 Poetry 的方式其实是一个原理：下载 Python 安装脚本 → 直接用 python 运行

✅ 总结一句话：

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

这条命令就是：

👉 “用 PowerShell 访问 Poetry 的安装网页，把下载到的安装脚本立刻用 Python 执行起来，一键完成 Poetry 的安装”。