poetry安装

于 2025-04-04 12:32:06 发布
阅读量1k 收藏 17
点赞数 28
文章标签： Python Poetry 环境管理
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43276566/article/details/146990796
版权

poetry安装方式

安装地址：https://python-poetry.org/docs/#installing-with-the-official-installer

根据官方推荐安装方式（with official installer）的安装步骤：

  1. 打开powershell运行(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -（如果本地已经安装了Python或安装了Anaconda，则将py替换为python）

2、继续在poershell中添加环境变量：

setx PATH "%APPDATA%\Python\Scripts;%PATH%"

3、重启powershell，并运行poetry --version查看安装情况，若出现版本号则安装成功
在这里插入图片描述

在已有项目中使用poetry管理Python环境

step1：项目初始化
如果项目还没有使用 Poetry，需要先初始化：

poetry init

该命令会创建一个 pyproject.toml 文件，你可以按照提示填写项目信息，或者直接按回车使用默认值。

step2：安装依赖
如果项目已经有 pyproject.toml 文件：

poetry install

该命令会：

  • 创建一个虚拟环境（如果还没有）
  • 安装 pyproject.toml 中列出的所有依赖
  • 生成/更新 poetry.lock 文件确保依赖版本一致

项目结构报错及解决方案

报错为：

Error: The current project could not be installed: No file/folder
found for package ai-agent-test

分析项目结构为：

C:.
│  poetry.lock
│  pyproject.toml
│  README.md
└─src
        demo.py
        from agents import Agent, Runner.py
        test.py
        test2.py
        __init__.py

pyprojects.toml文件内容为：

[project]
name = "ai-agent-test"
version = "0.1.0"
description = ""
authors = [
    {name = "pengkangzhen",email = "kangzhenpeng@outlook.com"}
]
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    "seaborn",
    "numpy",
]


[build-system]
requires = ["poetry-core>=2.0.0,<3.0.0"]
build-backend = "poetry.core.masonry.api"

执行poetry install报错如下：

PS C:\Users\pengkangzhen\PythonProjects\ai-agent-test> poetry install
Updating dependencies
Resolving dependencies... (7.4s)

Package operations: 15 installs, 0 updates, 0 removals

  - Installing numpy (2.2.4)
  - Installing six (1.17.0)
  - Installing contourpy (1.3.1)
  - Installing cycler (0.12.1)
  - Installing fonttools (4.57.0)
  - Installing kiwisolver (1.4.8)
  - Installing packaging (24.2)
  - Installing pillow (11.1.0)
  - Installing pyparsing (3.2.3)
  - Installing python-dateutil (2.9.0.post0)
  - Installing pytz (2025.2)
  - Installing tzdata (2025.2)
  - Installing matplotlib (3.10.1)
  - Installing pandas (2.2.3)
  - Installing seaborn (0.13.2)

Writing lock file

Installing the current project: ai-agent-test (0.1.0)
Error: The current project could not be installed: No file/folder found for package ai-agent-test
If you do not want to install the current project use --no-root.
If you want to use Poetry only for dependency management but not for packaging, you can disable package mode by setting package-mode = false in your pyproject.toml file.
If you did intend to install the current project, you may need to set `packages` in your pyproject.toml file.

错误原因

  1. 缺少 packages 配置。当前 pyproject.toml 中未定义 packages 字段，导致 Poetry 无法识别项目的代码位置。默认情况下，Poetry 会尝试在根目录下查找包（如 ai-agent-test/ 目录），但你的代码实际位于 src/ 目录中，因此匹配失败。
  2. ​项目结构问题。项目代码放在 src/ 目录下，但 Poetry 默认不会自动扫描 src/ 目录，除非显式配置。

解决方案

方法 1：修改 pyproject.toml（推荐）
在 pyproject.toml 中添加 packages 配置，明确指定代码路径：

[tool.poetry]
name = "ai-agent-test"
# ...其他配置...

# 添加以下内容
packages = [
    { include = "ai-agent-test", from = "src" }
]

方法 2：调整项目结构
将代码从 src/ 移动到根目录下的 ai-agent-test/ 目录（与项目名一致）：

├── pyproject.toml
├── ai-agent-test/  # 代码移到这里
│   ├── __init__.py
│   ├── demo.py
│   └── ...
└── src/  # 删除或保留（不再使用）

peotry项目结构

在使用 Poetry 和 VSCode 管理 Python 项目时，推荐的标准项目结构如下：

项目结构示例

a_demo_test/
├── src/                    # 主源码目录（推荐）
│   └── your_package_name/  # 项目核心包（与项目名相同，需在 pyproject.toml 中声明）
│       ├── __init__.py     # 表明这是 Python 包
│       └── main.py         # 逻辑代码入口
├── tests/                  # 单元测试目录
│   └── test_sample.py      # 测试代码（格式：test_*.py）
├── pyproject.toml          # Poetry 项目配置和依赖清单
├── README.md               # 项目文档
└── .gitignore              # Git 忽略规则

a_demo_test/
├── src/                   # 主源码目录
├── tests/                 # 测试代码
├── data/                  # 数据文件目录（可自定义名称）
│   ├── input/             # 输入数据（如配置文件、初始数据集）
│   └── output/            # 程序生成的持久化结果（如 CSV、JSON 文件）
├── logs/                  # 日志文件
├── temp/                  # 临时文件（程序运行中生成，可定期清理）
├── pyproject.toml         # Poetry 配置
└── .gitignore             # 需忽略非源码文件

核心结构说明

1. 源码位置
  • 推荐位置：放在 src/your_package_name 中（替换 your_package_name 为实际包名）。
  • 优势：
    • 避免开发者误导入本地文件（如 tests 中的代码意外依赖工作目录的配置）。
    • 符合 Python 官方打包规范 (PEP 621)。
2. 测试代码
  • 位置：tests/ 目录。
  • 工具：推荐使用 pytest（在 pyproject.toml 中添加依赖）。
3. 依赖管理
  • 初始化项目：在项目根目录运行：
    poetry init  # 交互式生成 pyproject.toml
poetry install  # 安装依赖并创建虚拟环境
  • 安装新依赖：
    poetry add requests  # 添加并写入 pyproject.toml
4. VSCode 配置建议
  1. 选择虚拟环境解释器：
    • 按下 Ctrl+Shift+P → 输入 Python: Select Interpreter → 选择 Poetry 创建的虚拟环境。
  2. 测试集成：
    在 .vscode/settings.json 中添加：
    {
  "python.testing.pytestArgs": ["tests"],
  "python.testing.unittestEnabled": false,
  "python.testing.pytestEnabled": true
}

示例pyproject.toml片段

[tool.poetry]
name = "your_package_name"  # 必须与 src/ 下的包名一致
version = "0.1.0"
packages = [{ include = "your_package_name", from = "src" }]  # 关键配置！

[tool.poetry.dependencies]
python = "^3.9"
requests = "*"

[tool.poetry.group.test.dependencies]
pytest = "^7.0"

其他注意事项

  • 无需 __init__.py 的目录：
    tests/ 和 src/ 本身不需要此文件，但包目录（如 src/your_package_name）必须有。
  • 模块导入正确性：
    在代码中使用绝对导入（如 from your_package_name import utils）。

通过遵循此结构，你的项目将易于维护、测试和分发。

Python 依赖管理和打包工具 Poetry 安装和测试
m0_64355682的博客
04-05 1万+
Poetry 是 一个 Python 依赖管理和打包工具。 它允许您声明项目所依赖的库，并将为您管理（安装/更新）它们。 官网： https://python-poetry.org/ Poetry 安装方法有三种： With the official installer With pipx With pip 官方推荐使用官方安装脚本，位于： https://python-poetry.org/docs/。 注意： get-poetry.py 脚本将在 Poetry 1.2 中被 install-
在 Windows 上安装和配置 Poetry
不知道你是通过何种途径访问到这里，总之欢迎来到red velet的博客
03-09 1615
Poetry 是一个强大的 Python 依赖管理工具，适用于现代化的 Python 开发流程。通过本教程，你已经学会了如何在 Windows 上安装 Poetry、配置环境变量、修改默认下载源，并掌握了基本的 Poetry 命令。希望这些内容能帮助你更高效地管理 Python 项目！
poetry install 失败
wangwangago的博客
07-12 2777
可以尝试删除AppData\Local\pypoetry\Cache\artifacts文件夹。通过poetry导出依赖到requirements.txt，然后通过pip安装依赖。
poetry安装与使用
最新发布
什么都干的派森
03-21 927
poetry默认虚拟环境创建在系统目录，这里我们修改配置，将默认虚拟环境创建在项目目录。进入项目跟目录，如果项目下有不是poetry创建的env目录，就先删了。记录第三方包的依赖关系（这个文件不用管）一路回车就行（有个作者名称要输一下）随便安装一个第三方包（在项目跟目录下。pycharm配置poetry环境。搞完后项目跟目录下会生成一个。文件，记录虚拟环境项目信息。生成poetry的env目录。，方便后面创建环境使用）安装第三方包后会生成一个。
poetry-install:诗歌安装GitHub行动
05-20
诗歌安装动作 此javascript操作将安装，然后调用该以安装项目依赖项。 用法示例 ... - uses : actions/checkout@v1 - uses : actions/setup-python@v1 - uses : knowsuchagency/poetry-install@v1 env : POETRY_VIRTUALENVS_CREATE : false 更简洁 ... - uses : actions/checkout@v1 - uses : actions/setup-python@v1 - run : | pip install -U pip pip install poetry poetry install env : POETRY_VIRTUALENVS_CREATE : false
安装poetry
菜鸟的博客
11-05 1万+
因为是python的第三方库，我们可以直接用pip install poetry来下载poetry；但是这会有个弊端，就是安装poetry的同时也会安装一大堆依赖库，因而会污染全局的python环境。因此这里选择用pipx来安装poetry。然后的话pipx给所安装的包也搞了个虚拟环境，我们要找poetry的执行文件（比如pycharm里面要求输入的poetry路径）怎么找呢？2. 在venvs路径下的poetry\Scripts\poetry.exe就是poetry的可执行文件了。
Poetry的安装
Hallo_ween的博客
09-26 7393
这是官方的如果安装过程中有什么错误的，请以官方文档为主Linux, macOS, Windows (Windows 上的 Linux 子系统)请使用如下指令上面教程都会安装在默认的路径，如果需要更改安装位置请参考官方这里我编写了一个一键安装脚本。大家可以使用一下。
Poetry安装教程
m0_50281408的博客
10-24 2151
Poetry官网Poetry-GitHub地址Poetry 是一个用于 Python 依赖管理和打包的工具。它允许您声明项目所依赖的库，并为您管理（安装/更新）它们。Poetry 提供了一个lockfile以确保可重复的安装，并且可以为您的项目构建分发版本。Poetry、Pipenv和VirtualenvPoetry、Pipenv和Virtualenv都是Python的依赖管理和打包工具，但它们各有特点。
Poetry教程一（Poetry安装与卸载）
热门推荐
成都-阿木木的博客
12-17 4万+
Poetry Poetry是一个依赖项管理和打包工具，它允许您声明项目所依赖的库，它将为您管理（安装/更新）它们。 安装所需python版本python3.6+，python2.7和python3.5由于不在维护，所以尽量不要安装。 安装方式： 1、在osx / linux / bashonwindows（windows下的linux子系统）下安装： curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/ge
install-poetry:Github用于安装和配置诗歌的动作
05-14
安装诗歌动作 Github动作，用于安装和配置。 该操作将安装Poetry，将可执行文件添加到跑步者系统路径，并设置相关的Poetry配置设置。 受到启发。 用法 如果您需要的只是默认诗歌，只需将其添加到您的工作流程中即可： - name : Install Poetry uses : snok/install-poetry@v1.1.4 如果要设置诗歌配置设置或安装特定版本，则可以指定输入 - name : Install and configure Poetry uses : snok/install-poetry@v1.1.4 with : version : 1.1.6 virtualenvs-create : true virtualenvs-in-project : false virtualenvs-path : ~/my-c
Poetry2009Setup
06-01
包含先秦到现当代的所有诗词，以及中华散文、古诗文等等。
docker-python-poetry:预先安装了Poetry的Python docker映像
04-01
一个预先安装了诗歌的基于Debian的python docker容器。 该图像是根据官方的python slim-buster图像构建的。 在上查看图像 根据要查找的python版本，有一些不同的标签。 标签结构是POETRY VERSION，然后是PYTHON ...
poetry安装torch
03-16
好的，用户想了解如何通过Poetry安装PyTorch。首先，我需要回忆一下Poetry的基本用法。Poetry是一个Python的依赖管理和打包工具，类似于pipenv，但有自己的配置文件pyproject.toml。安装包通常使用poetry add命令。 ...
poetry 安装步骤
qq_56463139的博客
12-27 1865
为了使用 poetry 来管理 Python 项目的依赖关系。以下是详细的安装步骤： 安装 Poetry 方法一：使用官方推荐的安装脚本 打开终端： 确保你已经打开了终端窗口。 运行安装脚本： 使用以下命令来安装 poetry： curl -sSL https://install.python-poetry.org | python3 - 如果你没有安装 python3 或者默认的 python 命令指向的是 Python 2，请确保你使用的是 Python 3 的路径。 添加到 PATH：
[python]poetry安装和使用
FL1623863129的博客
11-27 2751
这会将您带入一个 shell 会话，其中已经激活了 Poetry 的虚拟环境。在这个会话中，您可以运行 Python 命令和脚本，而无需手动激活环境。），Poetry 可能会跳过依赖更新，因为锁文件中已经定义了依赖的版本。一旦虚拟环境被激活，您可以开始使用您的项目了。在项目创建后，您需要激活 Poetry 创建的虚拟环境。的新目录，并在其中生成一个基本的 Poetry 项目结构。如果你只想移除某个库，但不希望影响其他已安装的包，可以使用。是您想要创建的项目的名称。中定义的所有依赖项，并激活虚拟环境。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值