poetry不是pip升级版，而是以pyproject.toml为唯一源的依赖管理工具；必须用poetry add/install操作，初始化须运行poetry init生成合规元数据，python字段需符合pep 440版本语法。
Poetry 不是 pip 的“升级版”，而是另一套依赖管理逻辑：它把 pyproject.toml 当作唯一真相源，不生成也不读取 requirements.txt。直接用 pip install 装包进 Poetry 环境会破坏锁定一致性，必须用 poetry add 或 poetry install 入口。
初始化项目时为什么不能跳过 poetry init？
因为 poetry init 会写入关键元数据块：[tool.poetry]（名称、版本、作者）、[tool.poetry.dependencies]（Python 版本约束、包列表）和 [build-system]（确保可构建）。手动编辑 pyproject.toml 容易漏掉 requires = ["poetry-core"] 或写错 Python 版本语法（比如写成 python = "^3.9" 而非 python = "^3.9" 是对的，但写成 python = "3.9" 就不会自动匹配 3.9.16）。
常见错误现象：poetry install 报错 InvalidVersion: Invalid version: '3.9'；或后续 poetry build 失败，提示 No module named 'poetry.core'。
- 运行
poetry init后按提示填完基本信息，它会自动生成合规结构 - 如果已有
setup.py，先删掉再 init，Poetry 不兼容 setup.py 驱动的构建流程 -
python字段必须用 PEP 440 兼容的范围表达式，例如"^3.9"、"~3.10"、">=3.8,
poetry add 和 poetry install 的分工是什么？
poetry add 修改 pyproject.toml 并更新 poetry.lock，是“声明依赖变更”；poetry install 读取 poetry.lock 安装确定版本，是“执行安装”。两者不可互换。
使用场景举例：开发中加新包用 poetry add requests；CI 流水线部署用 poetry install --no-dev（跳过 dev-dependencies）；本地重装全部依赖（比如换环境后）也用 poetry install，不是 poetry add --dry-run 之类伪操作。
-
poetry add pytest@^7.0会锁死到 7.x 最新版，下次poetry update才可能升到 8.x -
poetry add -D black加入[tool.poetry.dev-dependencies]，不影响生产环境 -
poetry install默认只装dependencies+dev-dependencies，加--with docs才装[tool.poetry.group.docs.dependencies]这类可选组
为什么 poetry export 导出的 requirements.txt 不能直接给 pip 用？
因为 poetry export -f requirements.txt 默认导出的是带哈希的锁定文件（--without-hashes 才去掉），且包含 Poetry 自己的注释行（如 # This file is autogenerated by Poetry），pip 会报错 Invalid requirement。
更关键的是：导出内容基于 poetry.lock，而 pip install -r 无法保证复现相同环境——它不解析依赖冲突、不处理平台标记（如 platform_system == "Windows"）、也不识别 extras 的条件依赖。
- 真要给 pip 用，加
--without-hashes --format requirements.txt > requirements.txt，再手动删掉首行注释 - 但仅限临时交接或容器基础镜像构建；长期协作请统一用
poetry install - CI 中若需 pip 安装（如某些云平台不支持 Poetry），优先用
poetry export --without-hashes -f constraints.txt > constraints.txt，再pip install -c constraints.txt package-name
最常被忽略的一点：Poetry 的虚拟环境路径默认藏在 ~/.cache/pypoetry/virtualenvs/，不是项目目录下。用 poetry env info --path 查看真实路径，调试时别在项目根目录里找 .venv。另外，poetry shell 启动的 shell 会修改 PYTHONPATH，若同时用了 python -m venv 手动建的环境，容易 import 错包。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
