应优先用pipreqs或pip list --format=freeze替代pip freeze，因后者默认输出@file:///路径导致不可移植；pipreqs通过分析import语句生成纯净依赖，而pip list --format=freeze可规避编辑安装路径但需手动删pip/setuptools等包。
pip freeze 输出包含绝对路径怎么办
直接 pip freeze 在虚拟环境中执行，常会把本地开发包（比如用 pip install -e ./mylib 安装的）写成类似 mylib @ file:///home/user/project/mylib 的形式——这导致导出的 requirements.txt 在其他机器上无法复现。
根本原因是 pip freeze 默认保留可编辑安装的完整 URL，而这类路径是机器/用户相关的。要剔除它，不能靠后期文本替换，得从源头控制输出格式。
- 优先用
pip list --format=freeze --not-required配合过滤：它不包含已满足依赖的包，但依然可能含@ file:// - 更可靠的是改用
pipreqs：它只扫描项目代码 import 语句，不读取已安装包状态，天然避开可编辑路径 - 若必须用
pip freeze，需先确保所有本地包都以 sdist/wheel 方式安装（pip install ./mylib），而非-e
pipreqs 生成 requirements.txt 的实操要点
pipreqs 不依赖当前环境已装什么，而是静态分析 import，所以导出结果干净、可移植，但容易漏装或误装。
执行前确认当前目录是项目根目录（含 __init__.py 或主入口文件），然后运行：
立即学习“Python免费学习笔记（深入）”；
pipreqs . --encoding=utf8 --savepath requirements.txt
常见问题和应对：
- 报错
ImportError: No module named 'xxx'：说明代码里 import 了未安装的包，先pip install xxx再重试 - 把测试/开发依赖也扫进去了：加
--ignore tests,migrations排除目录 - 没识别到动态 import（如
importlib.import_module）：这类必须手动补到requirements.txt - 版本宽松（如只写
requests）：加--use-local可尝试匹配本地已装版本，但不保证准确
用 pip-tools 管理带版本锁定的 requirements.in
如果需要精确复现环境（包括间接依赖），pip-tools 比 pip freeze 更可控，且默认不输出本地路径。
流程是：手写精简的 requirements.in（只列直接依赖），再编译出带哈希和全版本的 requirements.txt：
echo "requests>=2.28" > requirements.in<br>pip-compile requirements.in
关键点：
-
pip-compile会忽略-e包，除非你在requirements.in里显式写-e ./mylib—— 这时它仍会转成file://，需配合--no-emit-find-links和私有 index 替代 - 编译后生成的
requirements.txt含--hash校验，适合 CI/CD，但体积大、难手动改 - 若项目含 C 扩展或平台相关包（如
pywin32），需加--platform manylinux2014 --target-dir wheels/提前预编译
为什么不能简单 sed 替换 file:// 路径
有人想用 sed 's|file://.*mylib|mylib==1.0.0|g' 处理 pip freeze 输出，这在多数情况下会失效。
原因很实际：
- 不同系统路径分隔符不同（Windows 用
\，Linux/macOS 用/），正则难全覆盖 - 同一包可能有多个安装来源（
git+https、http://、file://），替换逻辑易冲突 - 版本号可能缺失或不一致：
pip freeze对-e包通常不写版本，硬填==1.0.0可能导致运行时行为变化 - 丢失依赖树结构：
pip freeze不体现依赖关系，纯文本替换后无法验证是否满足上游约束
真正要导出“不带本地路径”的清单，核心不是修输出，而是修安装方式和生成逻辑——选对工具链比修结果更省事。
