PyCharm 2025.2 Help

在 PyCharm 中配置项目

无论您在 PyCharm 中做什么,都是在 项目的上下文中进行的。 项目是表示完整软件解决方案的组织单元。 它是代码辅助、大规模重构、代码风格一致性等功能的基础。

项目文件

PyCharm 中的项目以 基于目录的格式表示。 项目目录用 项目目录图标 图标标记。

这样的项目目录包含 .idea 目录,其中包括以下文件:

  • .iml 文件描述了项目结构。

  • workspace.xml 文件包含您的工作区首选项。

  • 若干 xml 文件。 每个 xml 文件负责其自己的设置集,可以通过其名称识别: projectCodeStyle.xml encodings.xml vcs.xml 等。

    例如,添加新的运行/调试配置和更改编码将影响两个不同的 xml 文件。 这有助于避免当项目设置存储在版本控制系统中并由不同团队成员修改时的合并冲突。

.idea 目录中的所有设置文件都应 置于版本控制之下,除了 workspace.xml ,它存储您的本地首选项。 workspace.xml 文件应 被 VCS 标记为忽略

.idea 目录在 项目工具窗口 的项目视图中不可见。

项目类型

每个项目的目录结构包含一个 .idea 目录,用于 PyCharm 特定的设置、项目文件和库。

PyCharm 提供以下类型的项目:

  • 纯 Python 项目 适用于纯 Python 编程。 此类项目的目录结构包含用于 PyCharm 特定设置和项目文件的 .idea 目录以及库。

    按照 创建一个 Python 项目 部分中描述的方式创建一个普通的 Python 项目。

  • Django 项目。 此项目类型提供 Django 应用程序的特定基础结构,以及所有必要的文件和设置。

    按照 创建一个 Django 项目 部分中描述的方式创建一个 Django 应用程序。

    使用 Django 应用程序需要一个数据库。 建议使用 SQLite,因为它已预配置。 如果您使用的是其他数据库引擎,请确保其已正确安装和配置。

  • Flask 项目。 此项目类型提供 Flask 应用程序的特定基础结构,以及所有必要的文件和设置。

    按照 创建 Flask 项目 部分中描述的方式创建一个项目。

PyCharm Edu 项目

  • 教学项目旨在面向希望学习 Python 的学生。

    教育项目由以下实体组成:

    创建此类项目的过程在 学习者入门指南 中有所描述。

  • 课程 适用于教育工作者。

    课程由以下实体组成:

    课程

    课程 只是一个特殊类型的项目。 它由 课时 组成。

    课目

    课时 是存储任务文件的目录。 每个课时可以包含多个任务。

    任务

    任务 是存储以下文件的目录:

    • 任务描述,您需要在 任务描述 工具窗口中输入。

    • 扩展名为 .py 的文件,包含练习代码,并可能包含答案占位符。

    • 测试文件 tests.py ,帮助您确保学生正确完成了任务。

    任务还可以包含完成任务所需的更多文件。

    答案占位符

    答案占位符 是显示给学生的框架,用于替换并隐藏您初始代码的一部分。 这些占位符应包含学生完成任务所需采取的 操作描述。 您需要自行创建这些操作的描述。

    第一次鼠标点击答案占位符时会选中整个占位符;第二次点击会取消选中。

    提示

    如果学生不确定,可以查看 提示。 提示也是由教育工作者创建的。

    除了这些文件组,PyCharm 提供了特殊文件 test_helper.py ,其中包含讲师可用于编写测试的有用功能。

    有关更多信息,请参阅 教育者入门指南

项目设置

项目设置仅适用于当前项目。 它们与其他项目文件一起存储在 .idea 目录中的 .xml 格式中。 例如,项目会保存 VCS 设置、代码风格拼写检查器设置、语言注入列表等。 当您将应用程序代码发送到 VCS 时,这些设置会与您的代码一起自动置于版本控制之下。

要配置项目设置,请在 macOS 上选择 PyCharm | 偏好设置Ctrl+Alt+S ),或在 Windows 和 Linux 上选择 文件 | 设置

设置 对话框中,标有 项目可配置 图标的设置仅适用于当前项目。 其他设置是 global的,并适用于所有现有项目。

项目设置

如果您想在已存在的项目之间共享项目设置,您可以使用 Settings Sync 插件。 您还可以 将设置导出到 ZIP 存档 ,并稍后将其导入到其他 IDE 实例。

您不仅可以为当前项目配置项目设置,还可以为以后创建的所有项目配置。 这意味着您可以为您的项目设置新的默认设置。

配置默认项目设置

在主菜单中,转到 文件 | 新建项目设置 | 新项目的 设置

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