PyCharm 2025.3 Help

填充项目

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

创建新项

创建新文件

  1. 执行以下任一操作:

    • 项目 工具窗口(Alt+1 )中,选择要在其中创建新文件的 目录 或包,然后在主菜单中选择 文件 | 新建

    • 右键点击 目录 或包,然后在上下文菜单中选择 新建

    • 选择 目录,然后按 Alt+Insert

  2. 选择所需的文件类型。 通常,除 文件目录 外的所有选项都对应于使用文件模板。

    新建文件菜单

    如果某个现有文件模板是自定义模板,且其文件扩展名(模板扩展名)与任何已识别的文件类型的已注册模式不匹配,则该模板可能不会出现在列表中。 在这种情况下,您可以为某个现有的已识别文件类型注册相应模式,或添加一种新的文件类型并为该新类型注册相应模式。 有关详细信息,请参阅 文件类型关联

  3. 在打开的对话框中,在相应字段中输入文件名。 请注意,您不应输入文件扩展名。

    添加新的 Python 文件

    您可以在新文件名前指定整个目录结构。 如果嵌套目录尚不存在,将会创建它们。

    在指定目录中新建文件

    如有需要,指定新建的基于模板的文件的类型、其扩展名及其他参数。 例如,如果您选择创建 HTML 文件,您将能够创建 HTML、HTML4 或 XHTML 文件。 换言之,请使用相应的相关文件模板之一。

    按需指定其他信息。 例如,如果相应的文件模板包含此类自定义变量且当前未设置其值,系统可能会要求您定义这些变量的值。

  4. 点击 确定。 将会在目标位置下创建与所选文件模板对应的新文件。

    如果在新文件名前指定了不存在的子目录名称,则将在目标目录下创建整个结构:

    新建文件

    有时,您可能希望更改自动生成的文件扩展名。 为此,请使用 重命名重构重构 | 重命名)。

创建目录

  1. 打开 项目 工具窗口(例如, 视图 | 工具窗口 | 项目)。

  2. 选择目标目录。

  3. 执行以下任一操作:

    • 选择 文件 | 新建 | 目录

    • 在上下文菜单中选择 新建 | 目录

    • 选择该节点,然后在工具栏上点击 ,或按 Alt+Insert。 然后选择 目录

    创建目录
  4. 在打开的对话框中,指定目录名称。 如果您想创建多个嵌套目录,请以斜杠分隔目录名称。

    新建目录对话框

    Enter 以完成操作。

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

Python 包节点使用 包 图标标记。

创建 Python 包

  1. 项目 工具窗口中,选择目标目录。

  2. 在所选内容的上下文菜单中,选择 新建 | Python 包 ,或按 Alt+Insert 调用上下文菜单:

    创建包
  3. 在打开的 新建包 对话框中,指定包名。

    您也可以指定嵌套包;在这种情况下,名称应以点分隔:

    包名

    点击 确定。 PyCharm 将创建新的包或包结构:

    生成包

现在,您已创建包,可以执行以下操作:

  • 将该包导入到项目文件中。 使用代码补全来发现该包。

  • 将该包 提交并推送 到 VCS 存储库。

  • 在虚拟环境中 本地 或从 VCS 安装该包,以便您可以在使用该环境的其他项目中使用它。

如果您希望确保来自同一目录的导入可以解析,请将该目录标记为 命名空间包

将目录标记为命名空间包

  1. 设有两个包, lib1 lib2 ,位于同一目录中。 尝试在 lib2.py 中加入 lib1 导入语句。 PyCharm 会报告包之外的相对导入。

    包之外的相对导入
  2. 要解析该导入并避免警告,请将 mydir 目录标记为命名空间包。 您有以下选项:

    • 将插入符号置于该导入语句处,按 Alt+Enter (或点击黄色灯泡),并应用相应的快速修复。

    • 项目 工具窗口中右键点击该目录,然后选择 标记目录为 | 命名空间包

添加现有项

您可以使用以下任一方法将现有文件和文件夹添加到项目中:

  • 将该项从系统文件管理器拖动到 项目 工具窗口中的节点(Alt+1)。

  • 在系统文件管理器中复制该项,然后将其粘贴到 IDE 项目 工具窗口中的节点。

  • 在系统文件管理器中手动将该项移动到项目文件夹。

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