PyCharm 2025.2 Help

转换为包和模块

PyCharm 允许您通过将 Python 模块转换为 Python 包或反之来安全地重组您的源文件。

转换为 Python 包

通常是一个包含模块和初始化代码(文件 __init__.py )的目录。 模块 是一个 .py 源文件,包含可以导入到其他模块的 Python 定义。

将 Python 模块转换为 Python 包

  1. 选择一个 .py 文件。

  2. 请选择 重构(R) | 转换为Python 软件包

    重构 Python 模块为包
  3. 检查项目:已创建以转换模块命名的包; __init__.py 文件包含 .py 文件中的所有代码。

创建包后,您可以向其中添加更多新模块,或者使用 复制和移动重构 从初始实现中派生模块。 您还可以修改 __init__.py 文件,为包添加一些初始化代码,或者通过使用 __all__ 变量列出所有添加的模块。

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

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

  • 提交并推送 包到 VCS 仓库。

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

转换为 Python 模块

您可能需要将包中的所有模块合并为一个模块。

将 Python 包转换为 Python 模块

  1. 为重构准备您的包:将包中所有模块的代码移动到 __init__.py 文件中。 请参阅 复制和移动重构 了解更多详细信息。 这是关键操作,因为只有空包(仅包含 __init__.py 文件而没有其他文件的包)才能转换为模块。

  2. 选择包。

  3. 请选择 重构(R) | 转换为Python 模块

    将包转换为模块
  4. 检查项目:已创建以转换包命名的 .py 文件;它包含 __init__.py 文件中的代码。

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