poetry export导出的requirements.txt不能直接pip install，因默认含哈希、带poetry注释、跳过dev/extras依赖，且不支持git/path/url依赖，pip会报错或安装失败。
poetry export 为什么导出的文件不能直接 pip install？
因为 poetry export 默认输出的是锁文件（poetry.lock）中解析出的精确版本，不含可选依赖、不含 extras、默认跳过开发依赖（--without dev），且不处理 git / path / url 类型依赖——这些都会导致 pip install -r requirements.txt 报错或安装失败。
导出带 extras 和 dev 依赖的 requirements.txt
按需组合参数才能覆盖真实使用场景：
- 加
--with dev包含开发依赖（如pytest、black） - 加
--with my-extra包含某个 extras（如poetry export --with server对应[project.optional-dependencies.server]） - 加
--format requirements.txt指定格式（必须显式指定，不能省略） - 加
--without-hashes去掉哈希值（否则 pip 会校验失败，尤其在跨平台或源变更时）
常用命令示例：
poetry export --format requirements.txt --without-hashes --with dev > requirements.txt
如何处理 git/path/url 依赖？
poetry export 遇到非 PyPI 依赖会直接报错：Exporting URLs, paths and VCS dependencies is not supported。这不是 bug，是设计限制。
- 若项目真依赖本地包（
./my-utils），先用poetry add ./my-utils安装，再在pyproject.toml中手动改为my-utils = {path = "./my-utils", develop = true}，然后poetry export仍会跳过它 - 正确做法：把这类依赖单独列在
requirements-dev.txt或文档里，导出时用--without dev避免冲突 - Git 依赖（如
some-pkg = {git = "https://github.com/user/repo.git", subdirectory = "pkg"}）无法导出，只能人工转成git+https://github.com/user/repo.git@main#subdirectory=pkg写入 requirements.txt
CI/CD 中该用 poetry install 还是 pip install -r？
优先走 poetry install，尤其在需要复现 lock 文件语义（如严格版本、标记、环境约束）时。pip install -r requirements.txt 是妥协方案，仅适用于：
- 部署目标环境不支持 Poetry（如某些旧版 Docker 基础镜像）
- 团队统一要求只用 pip + requirements.txt 流程
- 导出后必须人工检查并补全非 PyPI 依赖
注意：poetry install 会读取 poetry.lock，而 pip install -r 只看 requirements.txt —— 两者行为不等价，别默认认为“导出即可用”。
最易被忽略的一点：导出前务必先运行 poetry lock，否则 export 基于过期 lock 文件，版本可能和本地开发不一致。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
