PyCharm 2026.1 Help

创建 Python 项目

纯 Python 项目 旨在用于 Python 编程。 项目可帮助您将源代码、测试、所用库以及个人设置组织为一个整体。

如果您不需要项目,可以在 LightEdit 模式 中编辑文件,或创建一个 Python 文件 无需设置项目

  1. 要创建项目,请执行以下任一操作:

    • 转到 文件 | 新建项目

    • 欢迎屏幕 上,点击 新建项目

  2. 新建项目 对话框中,指定项目位置。 项目名称将自动根据指定路径中的文件夹名称生成。

    创建新项目
    创建 Python 项目
  3. 选择 创建Git 仓库将项目置于 Git 版本控制之下

    如果您希望 PyCharm 将 main.py 文件添加到您的项目中,请选择 创建 main.py 欢迎脚本。 该文件包含一个简单的 Python 代码示例,可作为您项目的起点。

    Python 项目中的欢迎脚本
  4. 如果您要继续使用 项目 venvuv基础 Conda 解释器,请选择相应的选项并点击 创建

    项目 venv

    PyCharm 会在项目文件夹中基于系统 Python 创建一个 virtualenv 环境。

    uv

    PyCharm 会将 uv 环境配置为项目解释器。

    基础 Conda

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

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

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

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

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

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

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

    • 如果您希望在 PyCharm 中创建 Python 解释器时复用此环境,请选中 对所有项目可用 复选框。

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

    • 从列表中选择 Python 版本。

    • 指定环境名称。

    • PyCharm 将检测到 conda 安装。

      如果 PyCharm 未自动检测到该安装,请指定 conda 可执行文件的位置,或点击 Conda 可执行文件位置 进行浏览。

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

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

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

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

      或者,按照 pipenv 安装步骤 查找可执行文件路径,然后在对话框中指定它。

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

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

    • 如果 PyCharm 未检测到 Poetry 安装,请点击 通过 pip 安装 poetry 以允许 PyCharm 为您自动安装 Poetry。

      或者,指定 Poetry 可执行文件的位置,或点击 浏览… 进行浏览。

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

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

    • 从列表中选择 Python 版本。

    • PyCharm 将检测到 uv 安装。

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

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

    • PyCharm 会检测到 Hatch 安装。

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

    • 选择环境。

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

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

    为新项目选择现有 conda 解释器

    要重用现有 conda 环境:

    • 按类型分组 切换为 Conda

    • 指定环境名称。

    • PyCharm 将检测到 conda 安装。

      如果 PyCharm 未自动检测到该安装,请指定 conda 可执行文件的位置,或点击 Conda 可执行文件位置 进行浏览。

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

    为新项目选择现有解释器

    要重用其他 Python 环境:

    • 按类型分组 切换为 Python

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

创建项目后,您可以继续配置 项目结构

2026年 3月 24日