poetry install 能避免“装完就崩”是因为它严格依据 poetry.lock 中已验证的完整依赖树执行，锁定版本、传递依赖与哈希值，确保跨环境一致性；而 pip install -r requirements.txt 仅顺序盲装，不解析依赖冲突，易导致 urllib3 等间接依赖被静默覆盖。
poetry install 不是“比 pip install -r requirements.txt 更高级”，而是解决后者在真实协作和部署中频繁崩溃的那部分问题：依赖冲突静默覆盖、环境不一致、分组语义缺失。
为什么 poetry install 能避免“装完就崩”
常见错误现象：改了 requests 版本，pip install -r requirements.txt 成功退出，但运行时报 ImportError: cannot import name 'Timeout' from 'httpx'——因为 httpx 和新 requests 共同依赖的 urllib3 版本被强行覆盖了。
这是因为 pip install -r 只按行顺序安装，不做依赖图分析；而 poetry install 严格依据 poetry.lock 中已验证的完整依赖树执行，所有包版本、传递依赖、哈希值都锁定。只要 poetry.lock 存在且未被手改，任意机器上安装结果完全一致。
-
poetry.lock缺失时，poetry install会停住并明确报错，比如Because httpx (0.25.0) depends on urllib3 (>=2.0.0) and requests (2.31.0) depends on urllib3 ( -
pip install -r遇到同样冲突，会直接覆盖旧版urllib3，不提示、不中断、不回滚 - CI 流水线里用
poetry install --without dev可精准排除pytest、black等，而requirements.txt无法表达“仅开发需要”
poetry add 为什么比手动改 requirements.txt 安全
使用场景：你想把 requests 升级到 2.31.0，同时确保 httpx、urllib3、charset-normalizer 仍兼容。
poetry add requests@2.31.0 会自动完成三件事：更新 pyproject.toml 中的约束、重算整个依赖图、写入新 poetry.lock 并校验所有包 SHA256 哈希；而手动编辑 requirements.txt 后执行 pip install -r，你得自己推断哪些间接依赖要同步调、是否要 pip freeze > requirements.txt 覆盖重写——一不小心就把 mypy 写进生产依赖里。
- 加开发依赖必须显式用
poetry add pytest --group dev，否则不会出现在默认安装列表中 -
pyproject.toml支持[tool.poetry.group.dev.dependencies]这类原生分组，requirements.txt完全没这个语法能力 -
pyproject.toml还能声明requires-python = "^3.9"，requirements.txt对 Python 版本无任何表达力
poetry.lock 为什么不能删、不能手改
错误操作：有人觉得 poetry.lock 太长太乱，直接 rm poetry.lock，再跑 poetry install ——结果 CI 构建失败，因为 Poetry 重新解析时选到了刚发布的 charset-normalizer==3.3.4（带内存泄漏），而原来 poetry.lock 锁的是安全的 3.3.2。
poetry.lock 不是给人读的文档，是给机器执行的“可信快照”。它记录每个包的精确版本、下载 URL、SHA256 哈希、全部传递依赖链。Poetry 下次运行时会校验哈希，一旦发现不匹配（比如手改过某行），会直接拒绝安装并抛出 Invalid lock file hash 错误。
- 删掉
poetry.lock= 主动放弃可复现性，把依赖选择权交还给网络和时间 - 手改
poetry.lock= 绕过 Poetry 的完整性校验机制，大概率导致后续poetry install失败或行为不可预测 - 唯一合法更新方式：通过
poetry add/poetry update触发 Poetry 自动重生成
真正难的不是学会命令，而是理解 poetry.lock 是工作流的锚点，不是可选附件；pyproject.toml 的分组和约束不是语法糖，而是把“开发”“测试”“生产”这些语义真正编码进配置的能力。漏掉这点，Poetry 就退化成另一个 pip 包装器。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
