创建一个 Python 项目
纯 Python 项目适用于 Python 编程。 项目帮助您将源代码、测试、使用的库以及您的个人设置组织为一个单元。
如果您不需要项目,您可以在 LightEdit 模式 中编辑文件,或者创建一个 无需设置项目的 Python 文件。
要创建项目,请执行以下操作之一:
转到 。
在 欢迎屏幕上,单击 新项目。
在 新项目 对话框中,指定项目位置。 项目名称将自动从指定路径中的文件夹名称派生。


选择 创建Git 仓库 以 将项目置于 Git 版本控制下。
如果希望 PyCharm 将
main.py文件添加到您的项目中,请选择 创建 main.py 欢迎脚本。 此文件包含一个简单的 Python 代码示例,可以作为您的项目起点。
如果您希望继续使用 项目 venv 或 基础 conda 解释器,请选择相应的选项并点击 创建。
- 项目 venv
PyCharm 在项目文件夹中基于系统 Python 创建一个 virtualenv 环境。
- 基础 conda
PyCharm 将 conda 基础环境配置为项目解释器。
要配置其他类型的解释器或使用现有环境,请选择 自定义环境。
接下来的步骤取决于您的选择:

从环境类型列表中选择 Conda。
从列表中选择 Python 版本。
指定环境名称。
PyCharm 会检测 conda 的安装。
如果 PyCharm 未能自动检测到安装,请指定 conda 可执行文件的位置,或单击
浏览查找该文件。

从环境类型列表中选择 Virtualenv。
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。
在 位置 字段中指定新的虚拟环境的位置,或者点击
并在您的文件系统中浏览位置。 新虚拟环境的目录应为空。
如果您希望将机器上全局 Python 中安装的所有包都添加到您将要创建的虚拟环境中,请选择 从基础解释器继承包 复选框。 此复选框对应
--system-site-packages选项的 virtualenv 工具。如果您希望在 PyCharm 中创建 Python 解释器时重用此环境,请选中 使所有项目可用 复选框。

从环境类型列表中选择 Pipenv。
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。
如果您已将基础二进制目录添加到您的
PATH环境变量中,则无需设置任何其他选项:pipenv 可执行文件的路径将自动检测。如果 PyCharm 未检测到 pipenv 可执行文件,请点击 通过 pip 安装 pipenv 以允许 PyCharm 自动为您安装。
或者,按照 pipenv 安装过程 发现可执行文件路径,然后在对话框中指定它。

从环境类型列表中选择 Poetry。
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。
如果 PyCharm 未检测到 Poetry 的安装,请单击 通过 pip 安装 poetry 以便让 PyCharm 自动为您安装 Poetry。
或者,请指定 Poetry 可执行文件的位置,或单击
浏览查找该文件。
要在项目目录中创建虚拟环境,请选择 创建项目内环境 复选框。

从环境类型列表中选择 uv。
从列表中选择 Python 版本。
通常,PyCharm 会检测到 uv 安装。
否则,请指定 uv 可执行文件的位置,或点击
浏览以找到它。

从环境类型列表中选择 Hatch。
通常,PyCharm 会检测到 Hatch 的安装。
否则,请指定 Hatch 可执行文件的位置,或单击
浏览查找该文件。
请选择一个环境。
Hatch 环境是为各种特定项目任务设计的工作区。 如果未显式选择任何环境,Hatch 将使用 默认环境。
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。

要重用现有的 conda 环境:
将 按类型分组 切换为 Conda。
指定环境名称。
PyCharm 会检测 conda 的安装。
如果 PyCharm 未能自动检测到安装,请指定 conda 可执行文件的位置,或单击
浏览查找该文件。
从列表中选择环境。 如果您手动指定了 conda 的路径,可能需要重新加载环境。

要重用 Virtualenv、Pipenv 或 Poetry 环境:
将 按类型分组 切换为 Python。
从列表中选择 Python 可执行文件,或点击
浏览其位置。
创建项目后,您可以继续配置 项目结构。