PyCharm 2025.2 Help

创建并运行 setup.py

PyCharm 提供了一项操作,可帮助创建 setup.py 脚本,用于构建、分发和安装模块。 一旦创建了 setup.py ,相应的操作将被禁用。

创建 setup.py

  1. 项目 工具窗口中,选择包。 然后,在主菜单中转到 工具 | 创建 setup.py

  2. 新建设置脚本 对话框中,指定包名、版本、作者、作者邮箱、包描述以及任何许可详情:

    创建一个 setup.py 文件
  3. 请点击 确定 完成准备。 PyCharm 创建了 setup.py 并在编辑器中打开它。

    编辑器中的 setup.py

    请注意,PyCharm 创建的 setup.py 文件仅包含有限的参数集。 您可能需要手动添加其余所需的详细信息。 有关 setup.py 参数的更多信息,请参阅 Python Packaging User Guide

当您处理任何包含 setup.py 的项目时,您可以运行一些任务来构建、安装和分发 setup.py 文件中描述的包。 PyCharm 帮助您创建以下格式的命令行序列:

setup.py <task> <arguments>

运行一个 setup.py 任务

  1. 在主菜单中,转到 工具 | 运行 setup.py

  2. 输入 setup.py 任务名称 对话框中,输入任务名称的字母。

    运行一个 setup 脚本

    请注意,星号通配符和 snake_case 名称的首字母会被识别。 当您输入时,建议列表会缩小,仅显示匹配的名称。 选择所需的任务,然后按 Enter

  3. 命令行 字段中,输入要执行的任务参数。

    为 setup.py 测试添加一个 CLI 参数

    如果不需要参数,您可以将此字段留空。

  4. 一旦您点击 确定 ,命令行将在 运行 工具窗口中开始执行。

    执行 setup.py 任务

    有关 setup.py 命令参数的更多信息,请参阅 Building and Distributing Packages with Setuptools

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