PyCharm 2025.3 Help

创建 Django 项目

Django 项目旨在使用 Django 高效开展 Web 开发。 PyCharm 负责创建 Django 应用所需的特定目录结构和文件,并提供正确的设置。

启用 Django 插件

此功能依赖于 Django 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Django 插件,然后选中插件名称旁的复选框。

创建新的 Django 项目

  1. 转到 文件 | 新建项目 ,或在 欢迎界面 中点击 新建项目 按钮。 将打开 新建项目 对话框。

    创建 Django 项目
  2. 新建项目 对话框中,执行以下操作:

    • 指定项目类型 Django

    • 指定项目位置。

    • 选择 创建Git 仓库将项目置于 Git 版本控制之下

    • 如果您希望使用 项目 venvuvConda 基础环境 解释器继续,请选择相应选项并点击 创建

      项目 venv

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

      uv

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

      Conda 基础环境

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

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

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

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

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

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

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

      • 如果您希望在 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 可执行文件,或点击 进行浏览。

  3. 点击 更多设置更多设置 ,并指定以下内容:

    • 模板语言 列表中,选择要使用的 语言

    • 模板文件夹 字段中,指定模板将被存储和加载的目录。 您可以指定尚不存在的目录名称;在这种情况下,将创建该目录。

    • 应用名称 字段中,输入要创建的 Django 应用的名称。

    • 如果需要创建管理界面,请选中 启用 Django 管理站点 复选框。

  4. 点击 创建

最后修改日期: 2025年 12月 2日