IntelliJ IDEA 2025.2 Help

创建一个 Python 项目

  1. 请前往 文件 | 新建(N) | 项目 或在 欢迎屏幕上,点击 新建项目

  2. 新建项目 对话框中,选择 Python 作为项目类型。

    新建 Python 项目:使用现有的解释器

    指定项目位置。 项目名称将根据指定路径中的文件夹名称自动生成。

  3. 如果您希望使用 项目 venv基础 conda 解释器,请选择对应选项并点击 创建

    项目 venv

    IntelliJ IDEA 会在项目文件夹中基于系统 Python 创建 virtualenv 环境。

    基础 conda

    IntelliJ IDEA 会将 conda 基础环境配置为项目解释器。

    如需配置其他类型的解释器或使用已有环境,请选择 自定义环境

    接下来的步骤取决于您的选择:

    使用 conda 环境创建项目
    • 从环境类型列表中选择 Conda

    • 从列表中选择 Python 版本。

    • 指定环境名称。

    • 通常,IntelliJ IDEA 会检测到 conda 的安装。

      否则,指定 conda 可执行文件的位置,或点击 Conda 可执行文件位置 进行浏览。

    使用 virtualenv 创建项目
    • 从环境类型列表中选择 Virtualenv

    • 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    • 指定新虚拟环境的位置在 位置 字段中,或者点击 虚拟环境位置 并在您的文件系统中浏览位置。 新虚拟环境的目录应该是空的。

    • 如果您希望将机器上全局 Python 中安装的所有包添加到您将要创建的虚拟环境中,请选择 从基础解释器继承软件包 复选框。 此复选框对应 --system-site-packages 选项的 virtualenv 工具。

    • 如果您希望在 IntelliJ IDEA 中创建 Python interpreters 时重用此环境,请选择 向所有项目开放 复选框。

    使用 Pipenv 创建项目
    • 从环境类型列表中选择 Pipenv

    • 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    • 如果您已将基础二进制目录添加到您的 PATH 环境变量中,则无需设置任何其他选项:pipenv 可执行文件的路径将自动检测。

      如果 IntelliJ IDEA 未检测到 pipenv 可执行文件,请点击 通过 pip 安装 pipenv 以允许 IntelliJ IDEA 自动为您安装。

      或者,按照 pipenv 安装过程 发现可执行文件路径,然后在对话框中指定它。

    使用 Poetry 创建项目
    • 从环境类型列表中选择 Poetry

    • 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    • 如果 IntelliJ IDEA 未检测到 poetry 可执行文件,请点击 通过 pip 安装 poetry 以允许 IntelliJ IDEA 自动为您安装 poetry。

      或者,点击 选择路径 并手动选择所需的文件,或在对话框中指定以下路径,将 jetbrains 替换为您的用户名:

      /Users/jetbrains/Library/Application Support/pypoetry/venv/bin/poetry
      C:\Users\jetbrains\AppData\Roaming\pypoetry\venv\Scripts\poetry.exe
      /home/jetbrains/.local/bin/poetry
    • 要在项目目录中创建虚拟环境,请勾选 创建项目内环境 复选框。

    使用 uv 创建项目
    • 从环境类型列表中选择 uv

    • 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    • 通常,IntelliJ IDEA 会检测到 uv 安装。

      否则,请指定 uv 可执行文件的位置,或点击 uv 可执行文件位置 以浏览选择。

    使用 Hatch 创建项目
    • 从环境类型列表中选择 Hatch

    • 通常,IntelliJ IDEA 会检测到 Hatch 安装。

      否则,请指定 Hatch 可执行文件的位置,或点击 uv 可执行文件位置 以浏览选择。

    • 选择一个环境。

      Hatch 环境是为各种特定项目任务设计的工作区。 如果未明确选择环境,Hatch 将使用 默认环境

    • 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    为新项目选择已有的 conda 解释器

    要重用现有的 conda 环境:

    • 类型 切换为 Conda

    • 指定环境名称。

    • 通常,IntelliJ IDEA 会检测到 conda 的安装。

      否则,指定 conda 可执行文件的位置,或点击 Conda 可执行文件位置 进行浏览。

    • 从列表中选择环境。 如果您手动指定了 conda 的路径,可能需要重新加载环境。

    为新项目选择已有的解释器

    要重用 Virtualenv、Pipenv 或 Poetry 环境:

    • 类型 切换为 Python

    • 从列表中选择 Python 可执行文件,或点击 来浏览选择。

  4. 点击 创建

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