直接用pip install -r requirements.txt即可,但需确保requirements.txt在当前目录、内容格式正确(utf-8无bom、lf换行、无多余空格)、python环境已激活且pip版本适配;任一环节出错都会导致失败。

直接用 pip install -r requirements.txt 就行,但前提是文件位置、内容格式和环境状态都对——错一个环节就卡住。
requirements.txt 文件必须放在当前工作目录下
命令不会自动找文件,它只认你当前终端所在的路径。如果你在 /home/user/myproject 下运行命令,那 requirements.txt 就必须在这个目录里,不能在子目录(比如 src/requirements.txt)或上层目录。
- 检查方式:终端里执行
ls requirements.txt,能列出就说明位置正确 - 如果文件在别处,要么
cd进去,要么用相对/绝对路径:pip install -r ./config/requirements.txt - 常见错误:
OSError: No such file or directory: 'requirements.txt',基本就是路径不对
文件内容不能有编码或换行问题
Windows 记事本保存的 UTF-8 带 BOM、Mac/Linux 的 CRLF 换行、空行末尾多空格,都可能让 pip 解析失败,尤其在 CI 或 Docker 环境里更敏感。
从QuickView趋势笔记生成韩语AI播客包,含双人主持脚本(Callie×Nick)、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版(15~20分钟)和压缩版(5~7分钟)。
- 推荐用 VS Code 或 PyCharm 编辑,保存时选 “UTF-8 无 BOM” + LF 换行
- 每行只能是包名、带版本约束,或以
#开头的注释;空行可以,但别在包名后加空格或制表符 - 错误示例:
requests == 2.31.0(等号两边有空格)→ pip 会报Invalid requirement - 正确写法:
requests==2.31.0或requests>=2.28.0或纯requests
安装时遇到版本冲突或编译失败怎么办
不是所有包都能“一键装完”,特别是涉及 C 扩展(如 lxml、psycopg2、numpy)或 Python 版本不匹配时。
- 先试
pip install --only-binary=all -r requirements.txt,跳过本地编译,强制用预编译轮子(wheel) - 如果提示某个包找不到满足的版本,比如
ERROR: Could not find a version that satisfies...,大概率是该包已从 PyPI 移除,或版本号写错了(如django==4.999) - 临时删掉那行再重试;确认后可手动查 PyPI 页面,改用可用版本
- 生产环境建议加镜像源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/,避免超时或限流
真正容易被忽略的是:pip freeze > requirements.txt 导出的是整个环境,包含你根本没用到的开发依赖或调试工具;而 pipreqs . --force 只扫 import,更干净——但前提是项目里没有动态 import 或字符串 import,否则会漏包。










