python使用 requirements.txt 管理所需的包

使用 requirements.txt 管理所需的包

• 2019/01/28
• 做者
   
  • 

若要与其余人共享项目、使用生成系统，或打算将项目复制到须要在其中还原环境的其余任何位置，必须指定项目须要的外部包。 建议的方法是使用 requirements.txt 文件 (readthedocs.org)，文件中包含安装相关包所需版本的 pip 命令列表。 最多见的命令是 pip freeze > requirements.txt，它将环境的当前包列表记录到 requirements.txt 中。

从技术上讲，任何文件名均可用于跟踪要求（经过安装包时使用 -r <full path to file>），但 Visual Studio 提供针对 requirements.txt 的特定支持：

• 若是已加载包含 requirements.txt 的项目，且想要安装该文件列出的全部包，请展开“解决方案资源管理器”中的“Python 环境”节点，而后右键单击环境节点并选择“从 requirements.txt 安装”：

• 若是环境中已安装全部必需的包，可在“解决方案资源管理器”中右键单击该环境，并选择“生成 requirements.txt”以建立必需的文件。 若是文件已存在，会出现有关如何进行更新的提示：

  • “替换整个文件”将删除存在的全部项、注释和选项。
  • “刷新现有条目”会检测包的要求并更新版本说明符，匹配当前安装的版本。
  • “更新并添加项”将刷新找到的任何要求，并将全部其余包添加到文件末尾。

由于 requirements.txt 文件的目的是冻结环境的要求，所以全部已安装的包都采用精确的版本编写。 使用精确的版本可确保轻松地在其余计算机上重现环境。 即便采用一个版本范围（做为另外一个包的依赖项）或使用安装程序而非 pip 安装了包，也会包含这些包。

若是包不能经过 pip 安装，且它出如今 requirements.txt 文件中，则整个安装会失败。 在这种状况下，手动编辑文件以排除此包或使用 pip 的选项来指包的可安装版本。 例如，你可能更喜欢使用 pip wheel 来编译依赖项，并向 requirements.txt 添加 --find-links <path> 选项：

output复制

C:\Project>pip wheel azure
Downloading/unpacking azure
    Running setup.py (path:C:\Project\env\build\azure\setup.py) egg_info for package azure

Building wheels for collected packages: azure
    Running setup.py bdist_wheel for azure
    Destination directory: c:\project\wheelhouse
Successfully built azure
Cleaning up...

C:\Project>type requirements.txt
--find-links wheelhouse
--no-index
azure==0.8.0

C:\Project>pip install -r requirements.txt -v
Downloading/unpacking azure==0.8.0 (from -r requirements.txt (line 3))
    Local files found: C:/Project/wheelhouse/azure-0.8.0-py3-none-any.whl
Installing collected packages: azure
Successfully installed azure
Cleaning up...
    Removing temporary dir C:\Project\env\build...

请参阅

• 在 Visual Studio 中管理 Python 环境
• 为项目选择解释器
• 搜索路径
• “Python 环境”窗口参考

反馈

咱们衷心期