根本原因在于Poetry默认复用poetry.lock中已解析版本，不自动响应pyproject.toml的非语义修改；需运行poetry lock --no-update同步锁文件，CI中须用poetry lock --check校验一致性。
为什么 poetry install 有时装的不是 pyproject.toml 里写的版本？
根本原因在于 Poetry 默认启用“依赖兼容性放宽”策略：它会尝试复用已解析过的锁文件（poetry.lock）中记录的版本，哪怕你手动改了 pyproject.toml 中某个包的约束（比如从 requests = "^2.28" 改成 requests = "2.28.2"），只要旧锁文件里已有满足该约束的版本，Poetry 就不会重新解析——它信任锁文件的确定性，但不自动感知你对 TOML 的“非语义修改”。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 改完
pyproject.toml后，**必须运行poetry lock --no-update** 强制重生成锁文件（不升级间接依赖），再poetry install - 若想彻底清空旧解析痕迹，删掉
poetry.lock再执行poetry lock；但注意这会触发全量重新解析，可能引入意外升级 - 检查是否误用了
poetry add requests@2.28.2—— 这种写法会绕过 TOML 声明，直接写进 lock，导致 TOML 和 lock 不一致
如何让 Poetry 在 CI 中真正保证“一次解析，处处一致”？
CI 环境里常见问题是本地开发机有缓存、CI runner 是干净环境，导致 poetry install 在两者上解析出不同版本。Poetry 的确定性只在锁文件完整且未被篡改的前提下成立。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- CI 脚本中 **始终先校验
poetry.lock是否与pyproject.toml同步**：poetry lock --check；失败则说明有人提交了没更新 lock 的 TOML 修改 - CI 安装时用
poetry install --no-dev --no-root（按需），避免因 dev 依赖缺失或 root 包未声明引发隐式行为 - 禁用 Poetry 缓存以排除干扰：
POETRY_CACHE_DIR=/dev/null poetry install；尤其在容器化 CI 中，缓存不可靠 - 确认 CI 使用的 Poetry 版本与本地一致（如都用
1.7.1），不同大版本间解析器逻辑可能变化
poetry update 升级后出现运行时错误，怎么精准回退？
不同于 pip 可直接看 pip list 回溯，Poetry 的 update 是批量重解析，很难直观看出哪个包实际变了。错误往往来自间接依赖的次要版本漂移（比如 urllib3 从 1.26.15 升到 2.0.7）。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 升级前先备份锁文件：
cp poetry.lock poetry.lock.pre-update - 用
diff快速定位变更：diff poetry.lock.pre-update poetry.lock | grep "^\+[a-zA-Z]" | head -20，重点关注顶层包和它们的直接子依赖 - 若只需回退单个包，**不要手动改 lock 文件**——改完会破坏 SHA256 校验；应改
pyproject.toml中对应包的版本约束，再poetry lock --no-update - 对关键服务，把
poetry.lock提交进 Git 并设置为不可跳过 CI 检查，这是唯一能锁定间接依赖的方式
PyPI 镜像、私有源或本地路径依赖导致解析失败怎么办？
Poetry 解析器对源的优先级和凭证处理比 pip 更严格。常见现象是 poetry install 卡住、报 RepositoryError 或解析出错版本，根源常是源配置冲突或认证失效。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确认镜像源仅用于 PyPI：用
poetry source add --priority=explicit --url=https://pypi.tuna.tsinghua.edu.cn/simple/ tuna，避免--default覆盖所有源 - 私有包若用
path = "./mylib"，确保该目录含有效pyproject.toml或setup.py，且 Poetry 版本 ≥ 1.4（旧版对 PEP 621 支持不全） - 涉及 HTTP Basic Auth 的私有源，凭证必须通过
poetry config http-basic.my-repo username password设置，硬编码 URL 里的 token 会被 Poetry 忽略 - 调试时加
-v参数：poetry install -v，输出会显示每个源的请求 URL 和响应状态码，比静默失败好排查得多
Poetry 的确定性不来自命令本身，而来自你是否让 poetry.lock 始终真实反映 pyproject.toml 的意图，并且所有环境都基于同一份 lock 执行安装。最容易被忽略的是：锁文件不是“生成一次就永续有效”的快照，它需要被当作源码一样受版本控制、受 CI 校验、受团队协作规范约束。
