PyCharm 2025.3 Help

在包与模块之间相互转换

PyCharm 允许您通过在 Python 模块与 Python 包之间相互转换，安全地重组您的源文件。

转换为 Python 包

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

要将 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年 12月 2日
更改签名引入变量