# 创建一个 Python 项目

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **Note:**
> 请确保 [Python 插件](https://plugins.jetbrains.com/plugin/631-python)已 [安装并启用](managing-plugins.html)。 该插件实现了面向 Python 开发者的独立 IDE [PyCharm](https://www.jetbrains.com.cn/pycharm/) 的全部功能。 有关受支持功能的详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com.cn/help/pycharm/)。

Procedure:

1. 请前往  `文件 | 新建 | 项目` 或在 [欢迎屏幕](null)上，点击  `新建 | 项目` 。

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

![新建 Python 项目：使用现有的解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_python_sdk_existing_interpreter.png)

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

3. 如果您要继续使用   项目 venv  、   uv   或   基础 conda   解释器，请选择相应的选项并点击   创建  。

项目 venv
: 选择   项目 venv   为项目创建虚拟环境。
:
:
:
: ![使用虚拟环境创建 Python 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_create_python_project_venv.png)
:
: 在   Python 版本   字段中，选择要用于虚拟环境的 Python 解释器。
:
:
:
: 虚拟环境会创建在项目根目录下的  `.venv`  目录中。
:
:
:
: > **Note:**
: > 如果系统中没有该 Python 版本，可以下载并安装。
: >
: >
: >
: > ![下载并安装 Python](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_download_python.png)
: >
: > 此功能仅在 Windows 和 macOS 上可用。

uv
: 选择   uv   为项目创建 uv 虚拟环境。
:
:
:
: ![使用 uv 环境创建 Python 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_create_python_project_uv.png)
:
: * 在 Python 版本 字段中，选择要用于环境的 Python 版本。
:
: * IntelliJ IDEA 会自动检测 uv 可执行文件。 如果未检测到，请在 uv 路径 中指定其位置。
:
: * 在 位置 字段中，指定创建虚拟环境的位置。 默认情况下，IntelliJ IDEA 会在项目根目录中创建 `.venv` 目录。

基础 conda
: 选择   基础 conda   将 Conda 安装的基础环境用作项目解释器。
:
:
:
: ![使用 Conda 环境创建 Python 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_create_python_project_conda.png)
:
: IntelliJ IDEA 会自动检测 Conda 可执行文件。 如果未检测到，请在   conda 路径   中指定其位置。

要配置其他类型的解释器或使用现有环境，请选择   自定义环境  。

以下步骤取决于您的选择:

生成新环境:

Virtualenv:

![使用 virtualenv 创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_virtualenv.png)

* 从环境类型列表中选择 Virtualenv 。

* 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 > **Note:** > 如果系统中没有该 Python 版本，可以下载并安装。 > > > > ![下载并安装 Python](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_download_python.png) > > 此功能仅在 Windows 和 macOS 上可用。

* 在 位置 字段中指定新虚拟环境的位置，或者点击 ![虚拟环境位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中浏览该位置。 新虚拟环境的目录应为空。

* 如果希望将计算机上全局 Python 中安装的所有软件包添加到将要创建的虚拟环境中，请选择 从基础解释器继承软件包 复选框。 此复选框对应 `--system-site-packages` 选项的 [virtualenv](http://www.virtualenv.org/en/latest/index.html) 工具。

Conda:

![使用 conda 环境创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_conda.png)

* 从环境类型列表中选择 Conda 。

* 从列表中选择 Python 版本。

* 指定环境名称。

* IntelliJ IDEA 将检测到 conda 安装。 如果 IntelliJ IDEA 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![Conda 可执行文件位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

Pipenv:

![使用 Pipenv 创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_pipenv.png)

* 从环境类型列表中选择 Pipenv 。

* 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 > **Note:** > 如果系统中没有该 Python 版本，可以下载并安装。 > > > > ![下载并安装 Python](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_download_python.png) > > 此功能仅在 Windows 和 macOS 上可用。

* 如果您已将基础二进制目录添加到您的 `路径` 环境变量中，则无需设置任何其他选项：pipenv 可执行文件的路径将自动检测。 如果 IntelliJ IDEA 未检测到 pipenv 可执行文件，请点击 通过 pip 安装 pipenv 以允许 IntelliJ IDEA 自动为您安装。 或者，按照 [pipenv 安装过程](null)来查找可执行文件路径，然后在对话框中指定该路径。

Poetry:

![使用 Poetry 创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_poetry.png)

* 从环境类型列表中选择 Poetry 。

* 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 > **Note:** > 如果系统中没有该 Python 版本，可以下载并安装。 > > > > ![下载并安装 Python](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_download_python.png) > > 此功能仅在 Windows 和 macOS 上可用。

* 如果 IntelliJ IDEA 未检测到 Poetry 安装，请点击 通过 pip 安装 poetry 以允许 IntelliJ IDEA 为您自动安装 Poetry。 或者，指定 Poetry 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

* 要在项目目录中创建虚拟环境，请选中 创建项目内环境 复选框。

uv:

![使用 uv 创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_uv.png)

* 从环境类型列表中选择 uv 。

* 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。

* IntelliJ IDEA 将检测到 uv 安装。 否则，请指定 uv 可执行文件的位置，或点击 ![uv 可执行文件位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

Hatch:

![使用 Hatch 创建项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_hatch.png)

* 从环境类型列表中选择 Hatch 。

* IntelliJ IDEA 将检测到 Hatch 安装。 否则，请指定 Hatch 可执行文件的位置，或点击 ![uv 可执行文件位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

* 选择环境。 Hatch 环境是为各种项目特定任务设计的工作区。 如果未明确选择环境，Hatch 将使用 [默认环境](https://hatch.pypa.io/latest/tutorials/environment/basic-usage/)。

* 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 > **Note:** > 如果系统中没有该 Python 版本，可以下载并安装。 > > > > ![下载并安装 Python](https://resources.jetbrains.com.cn/help/img/idea/2026.3/py_download_python.png) > > 此功能仅在 Windows 和 macOS 上可用。

选择现有环境:

conda:

![为新项目选择现有 conda 解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_existing_conda.png)

要重用现有 conda 环境：

* 将 类型 切换到 Conda 。

* 指定环境名称。

* IntelliJ IDEA 将检测到 conda 安装。 如果 IntelliJ IDEA 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![Conda 可执行文件位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

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

其他环境:

![为新项目选择现有解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_new_project_existing_other.png)

要重用其他 Python 环境：

* 将 类型 切换到 Python 。

* 从列表中选择 Python 可执行文件，或点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

4. 点击   创建  。

## See also

### 概念

[项目](creating-and-managing-projects.html)

