PyCharm 2025.2 Help

使用 Pipfile

Pipfile Pipenv 虚拟环境 用于管理项目依赖项的专用文件。 此文件是使用 Pipenv 的关键。 当您为新项目或现有项目创建 Pipenv 环境时, Pipfile 会自动生成。 该文件已添加到当前项目中,您可以在 项目 工具窗口中看到它。 同样,当您首次在 PyCharm 中打开包含 Pipfile 文件的项目时,Pipenv 虚拟环境会自动配置。

考虑从头开始创建依赖项列表的任务。

通过使用 Pipfile 管理项目依赖项

  1. 当 PyCharm 为新的 pipenv 虚拟环境创建 Pipfile 时,该文件如下所示:

    自动生成的 Pipfile

    python_version 参数是您在创建新的 Pipenv 虚拟环境 时指定的基础解释器版本。 packages 部分是您可以列出项目所需包的位置。

  2. 通过修改 packages 部分添加新的包依赖项。

    [packages] django = "*"
  3. 每次您修改 Pipfile 文件时,PyCharm 会建议以下操作之一:

    运行 pipenv update 或 pipenv lock 命令
    • pipenv lock — 将新需求记录到 Pipfile.lock 文件中。

    • pipenv update — 将新需求记录到 Pipfile.lock 文件中,并在 Python 解释器上安装缺失的依赖项。

    点击 pipenv update 以安装 Django 包。

  4. 打开 Python Packages 工具窗口 并确保已安装 Django。

    Django 包已添加

PyCharm 会跟踪 Pipfile 中列出的任何未满足的需求,并建议您应用受影响的依赖项。

应用依赖项

  1. 考虑一种情况,当您检出或更新项目源文件时,看到以下消息:

    Pipfile 中列出的包丢失

    这意味着您的虚拟环境不符合当前版本 Pipfile 中列出的需求。

  2. 点击 Pipfile.lock 中的安装要求 以安装缺失的包。

您可能已经注意到,除了 Pipfile 之外, Pipfile.lock 文件在管理 pipenv 项目需求方面也起着关键作用。 每次您执行 pipenv lockpipenv update 时,都会获取虚拟环境的当前快照。 查看以下片段:

Pipfile.lock 的片段

该文件记录了为项目安装的包的确切版本。 它还生成了哈希码,以便于安全部署您的应用程序。 当您从不受信任的来源下载依赖项时,哈希码用于确保项目文件是可信的。

使用 Pipfile 创建环境

  1. 当您打开包含 Pipfile 的项目但未配置项目解释器时,PyCharm 会建议您设置 pipenv 环境。

    检测到 Pipfile
  2. PyCharm 将显示 pipenv 可执行文件的路径。 通过点击 确定 确认路径。

  3. 如果 PyCharm 无法自动检测 pipenv 可执行文件,请手动指定其路径。

将为您的项目配置一个新的 pipenv 环境,并安装 Pipfile 中列出的包。

最后修改日期: 2025年 9月 26日