填充项目

创建项目后，您可以开始添加新项：创建新目录、包和文件，或添加现有文件和文件夹。

创建新项

创建新文件

请执行以下操作之一：
- 在 Project 工具窗口（Alt+1 ）中，选择要在其中创建新文件的目录或包，然后从主菜单中选择文件｜新建。
- 右键点击目录或包，并从上下文菜单中选择新建。
- 选择目录，然后按 Alt+Insert。
选择所需的文件类型。通常，除文件、打包和目录之外的所有选项都对应于使用文件模板。
如果某个现有文件模板不在列表中，可能是因为这是一个自定义模板，其文件名扩展名（模板扩展名）与任何已识别文件类型的注册模式不匹配。在这种情况下，您可能需要为现有的已识别文件类型注册相应的模式，或者添加一个新文件类型并为此新类型注册相应的模式。欲了解更多信息，请参阅文件类型关联。
在打开的对话框中，在相应的字段中输入文件名。请注意，您不应输入文件扩展名。
您可以在新文件名前添加完整的目录结构。若嵌套目录尚不存在，则会自动创建。如果嵌套目录尚不存在，它们将被创建。
如有需要，指定新基于模板的文件的类型、扩展名和其他参数。例如，如果选择创建 HTML 文件，您将可以创建 HTML、HTML4 或 XHTML 文件。换句话说，使用相应的关联文件模板之一。换句话说，使用一个对应的相关文件模板。
根据需要指定其他信息。例如，如果相应的文件模板包含自定义变量且这些变量的值当前未设置，您可能需要定义这些变量的值。
点击确定。与所选文件模板对应的新文件将被创建在目标位置。
如果在新文件名前指定了不存在的子目录名称，则整个结构将被创建在目标目录下：
有时，您可能需要更改自动生成的文件名扩展名。为此，请使用重命名重构（重构 | 重命名）。

创建目录

打开项目工具窗口（例如，视图 | 工具窗口 | 项目）。
选择目标目录。
请执行以下操作之一：
- 请选择文件 | 新建 | 目录。
- 从上下文菜单中选择新建 | 目录。
- 选择节点并点击工具栏上的或按 Alt+Insert。然后选择目录。
在打开的对话框中，指定目录名称。如果您想创建多个嵌套目录，请用斜杠分隔目录名称。
按 Enter 完成任务。

PyCharm 支持递归创建 Python 包，从而创建整个包结构。

Python 包节点用图标标记。

创建 Python 包

在 Project 工具窗口中，选择目标目录。
从所选内容的上下文菜单中选择新建 | Python 包，或按 Alt+Insert 调出上下文菜单：
在打开的新建包对话框中，指定包名称。
您还可以指定嵌套包；在这种情况下，名称应以点分隔：
点击确定。 PyCharm 创建了新的包或包结构：

现在您已创建一个包，您可以执行以下操作：

将包导入到项目文件中。使用代码补全功能发现它。
提交并推送包到 VCS 仓库。
在虚拟环境中本地或从 VCS 安装包，以便您可以在使用该环境的其他项目中使用它。

如果您想确保来自同一目录的导入能够解析，请将该目录标记为 namespace package。

将目录标记为命名空间包

考虑两个包， lib1 和 lib2 ，它们位于同一目录中。尝试将 lib1 导入语句包含到 lib2.py 中。 PyCharm 报告了包外的相对导入。
为了解决导入问题并避免警告，请将 mydir 目录标记为命名空间包。您有以下选项：
- 将光标放在导入语句上，按 Alt+Enter （或单击黄色灯泡），并应用相应的快速修复。
- 右键单击项目工具窗口中的目录，然后选择将目录标记为 | 命名空间包。

添加现有项

您可以使用以下选项之一将现有文件和文件夹添加到项目中：

将项目从系统文件管理器拖动到项目工具窗口中的节点（Alt+1）。
在系统文件管理器中复制项目，然后粘贴到 IDE 项目工具窗口中的节点。
手动将项目移动到系统文件管理器中的项目文件夹。

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