PyCharm 2025.3 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 打包用户指南

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

setup.py <task> <arguments>

运行 setup.py 任务

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

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

    运行 setup.py 脚本

    请注意,星号通配符以及 snake_case 名称的首字母均受支持。 在键入时,建议列表会缩小,仅显示匹配的名称。 选择所需任务,然后按 Enter

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

    为 setup.py test 添加 CLI 参数

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

  4. 点击 确定 后,命令行会在 运行 工具窗口中开始执行。

    执行 setup.py 任务

    有关 setup.py 命令参数的更多信息,请参阅 使用 Setuptools 构建和分发包

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