requirements.txt 中版本写法影响依赖控制：无版本装最新版；==锁死版本；>=搭配
requirements.txt 里写版本号的几种写法，效果完全不同
直接写 requests 表示安装最新版，但生产环境几乎从不这么干。真正可控的是带约束符的写法：requests==2.31.0 锁死精确版本；requests>=2.30.0, 限定范围；<code>requests~=2.31.0 等价于 >=2.31.0, （只允许补丁升级）。用 <code>== 最稳妥，尤其当依赖存在 ABI 不兼容变更时——比如 numpy==1.24.4 和 numpy==1.25.0 在某些 C 扩展调用上会直接报 ImportError: undefined symbol。
pip install -r requirements.txt 为什么有时没装对版本？
常见原因有三个：
• 当前环境中已存在更高版本的包（比如已有 django==4.2.7，而 requirements.txt 写了 django==4.1.0），pip install -r 默认不会降级；
• 使用了 --no-deps 或 --ignore-installed 等干扰参数；
• 文件里混入了注释或空行导致解析异常，比如 # django==4.1.0 被当成注释跳过，实际没生效。
解决方法：加 --force-reinstall --no-deps 强制重装（慎用），更推荐先清理：pip uninstall -y -r requirements.txt 再重新装。
如何验证安装结果是否和 requirements.txt 完全一致？
装完不能只信输出日志，得用工具比对：
• 运行 pip freeze > current.txt 导出当前环境所有包及版本；
• 用 diff requirements.txt current.txt 查差异（注意 pip freeze 输出含小写和下划线，而 requirements.txt 可能用短横线，如 django-filter vs django_filter）；
• 更可靠的是用 pip-check（需先 pip install pip-check），它会标出过期、缺失或版本错位的包；
• 如果项目用虚拟环境，建议每次新建干净环境测试：python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt。
Windows 下中文路径或空格导致 requirements.txt 安装失败
错误信息常为 ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'D:\my project\requirements.txt'，本质是 shell 解析路径失败。解决方案只有两个：
• 把项目路径改成纯英文、无空格（如 D:\pyproj\），这是最省心的做法；
• 在命令中用双引号包裹路径：pip install -r "D:\my project\requirements.txt"；
• 避免在 requirements.txt 内部用相对路径引用其他文件（如 -r ./sub/extra.txt），跨目录引用极易因工作目录不同而失效。
立即学习“Python免费学习笔记（深入）”；
版本锁定不是越死越好，但一旦写了 ==，就得承担手动更新和测试的成本。最容易被忽略的是子依赖冲突——比如 A 包要求 pydantic，B 包要求 <code>pydantic>=2.5，这时 pip install -r 会装上后者并静默覆盖前者约束，运行时才暴露问题。
