快速入门:通过 Cookiecutter 模板创建项目

在本快速入门教程中,按照指导步骤,从 Cookiecutter 模板创建一个新项目,包括发布到 GitHub 的多个项目。 Cookiecutter 可提供图形用户界面,用于发现模板、输入模板选项以及创建项目和文件。 Visual Studio 2017 及更高版本包括 Cookiecutter 扩展。 它可以单独安装在 Visual Studio 的早期版本中。

先决条件

  • 安装了 Python 工作负载支持的 Visual Studio。 有关详细信息,请参阅在 Visual Studio 中安装 Python 支持

  • Python 3.3 或更高版本(32 位或 64 位)或者 Anaconda 3 版本 4.2 或更高版本(32 位或 64 位)。

    • 如果适用的 Python 解释器不可用,Visual Studio 将显示警告。

    • 如果在 Visual Studio 运行时安装 Python 解释器,请选择“Cookiecutter 资源管理器”工具栏上的“主页”选项,检测新安装的解释器。 有关详细信息,请参阅在 Visual Studio 中创建和管理 Python 环境

使用 Cookiecutter 创建项目

  1. 在 Visual Studio 中,选择“文件”>“新建”>“从 Cookiecutter”。 此命令会在 Visual Studio 中打开一个 Cookiecutter 窗口,可在其中浏览模板。

    显示如何从 Visual Studio 2022 中的 Cookiecutter 模板创建新项目的屏幕截图。

    显示如何从 Cookiecutter 模板创建新项目的屏幕截图。

  2. Cookiecutter 窗口中,选择推荐部分下的 Microsoft/python-sklearn-classifier-cookiecutter 模板。

  3. 若要克隆并安装选定模板,请选择“下一步”

    首次使用特定模板时,该过程可能需要几分钟,因为 Visual Studio 将安装所需的 Python 包。

  4. 在本地安装并克隆模板后,Cookiecutter 会显示“选项”页,你可以在其中指定新项目的设置。

    显示如何在 Visual Studio 2022 中为新项目设置选项的屏幕截图。

    显示如何为新项目设置选项的屏幕截图。

    1. 将“创建到”字段设置为你希望 Visual Studio 存储新项目文件的位置,例如 C:\repos\python-sklearn-classifier-cookiecutter\

    2. 选择“创建并打开项目”。 (如果要将新项目添加到现有解决方案,则会看到“添加到解决方案”选项。)

    该过程完成后,你会看到消息已成功使用模板创建文件...。项目会在解决方案资源管理器中自动打开。

  5. 若要运行程序,请选择“调试”>“启动但不调试”,或使用键盘快捷方式 Ctrl+F5。 该程序会生成精度召回曲线图:

    显示 python-sklearn-classifier-cookiecutter 模板项目输出的屏幕截图。