在 VS Code 中尝试

项目管理

在 Visual Studio Code 中创建 C# 应用程序时,首先需要一个项目。项目包含所有编译成可执行文件、库或网站的文件(例如源代码、图像等)。然后,所有相关的项目可以存储在一个称为解决方案的容器中。本文向您展示如何通过解决方案管理器视图维护您的所有项目及其各自的文件。

注意:在 VS Code 中使用解决方案管理器视图需要安装C# Dev Kit 扩展

解决方案管理器

新的 C# Dev Kit 扩展在主侧边栏中包含一个新的视图,即解决方案管理器。此视图提供了您的应用程序、其解决方案和项目的结构化视图,便于集中式项目管理。当您打开包含 .NET 解决方案文件或项目文件的工作区时,解决方案管理器将自动出现。

如果工作区中只有一个解决方案文件(.sln 文件),解决方案管理器将检测到该文件并在工作区加载后自动加载它。例如,请看下面的动画,展示了打开包含单个解决方案文件的工作区的体验。

Open workspace with 1 solution file

在上面的动画中,工作区首次加载到 VS Code 中。工作区加载后,解决方案管理器检测到唯一的 .sln 文件并自动加载它。

当工作区中有多个解决方案文件时,系统会提示您选择要加载的特定解决方案文件。工作区加载解决方案文件后,扩展会记住上次加载的解决方案文件,并在 VS Code 中加载工作区时自动重新加载该文件。在下面的动画中,您可以看到首次打开包含多个解决方案文件的工作区的体验。

Open workspace with multiple solution files

在上面的视频中,工作区加载后,解决方案管理器检测到工作区包含多个解决方案文件,并提示您使用标准的 VS Code 通知选择要加载的解决方案。今后当您打开同一个工作区时,解决方案管理器会记住上次加载的解决方案文件并自动重新加载它。

当解决方案管理器中已加载解决方案并希望关闭该解决方案时,可以使用关闭解决方案命令。右键单击解决方案管理器中的解决方案时,可以在上下文菜单中找到此命令。

Close solution context menu

您也可以在命令面板中调用此命令。您可以使用 ⇧⌘P(Windows、Linux Ctrl+Shift+P 打开命令面板。如下图所示。

Close solution from the Command Palette

关闭解决方案后,解决方案管理器将显示一个按钮,以便您以后可以从工作区打开解决方案文件。您也可以在命令面板中使用.NET: Open Solution 命令调用该命令。

当您调用打开解决方案命令时,如果工作区中只有一个解决方案文件,它将自动加载该文件。如果存在多个解决方案文件,系统将提示您选择要加载的解决方案文件。这与您首次打开包含一个或多个解决方案文件的工作区的体验相同。接下来讨论解决方案管理器中对解决方案文件夹的支持。

解决方案文件夹

在解决方案管理器中,如果解决方案包含解决方案文件夹(用于在解决方案中分组项目的虚拟文件夹),它们将被显示。在这里,您可以与解决方案文件夹内容进行交互。要添加新的解决方案文件夹,可以右键单击解决方案并选择新建解决方案文件夹菜单项。请看下面的短视频。

C# Dev Kit new solution folder

在上面的视频中,创建了一个名为 "tests" 的新解决方案文件夹。创建解决方案文件夹后,可以使用添加现有项目上下文菜单向其中添加项目。下面的动画展示了此体验。

Add existing project

您也可以使用下图所示的添加新文件上下文菜单向解决方案文件夹添加新文件。

Add file to solution folder

调用此命令后,系统将提示您在命令面板中选择要使用的文件模板。下图显示了此内容。

Add new file from Command Palette

此列表显示了扩展当前支持的解决方案文件夹的文件模板。要创建不使用模板的文件(即创建一个空白文件),请选择自定义文件(无模板)

要删除解决方案文件夹,可以使用上下文菜单中的移除选项。

Remove Solution Folder

从解决方案中移除解决方案文件夹时,该解决方案文件夹及其内容将从解决方案中移除。其中包含的文件和/或项目不会从磁盘中删除。既然我们已经讨论了解决方案文件夹,接下来看看如何在解决方案管理器中与项目进行更多交互。

使用项目

在解决方案管理器中,有许多功能可帮助您处理项目。首次打开解决方案时,您将看到项目和解决方案文件夹。您可以展开解决方案文件夹或项目以查看其内容。下图显示了展开了一些节点的解决方案管理器。

Solution Explorer with expanded nodes

在上图中,我们可以看到解决方案管理器中展开了几个解决方案文件夹,以及 TemplatesWeb 项目。此版本中对文件嵌套的支持是最小的,我们将扩展此支持,使其与 Visual Studio IDE 中的文件嵌套更加一致。

在这里,您可以通过双击解决方案管理器中的文件来打开它们。您也可以右键单击解决方案管理器中的项以获取可用操作的特定上下文菜单。例如,要向项目添加新文件,右键单击项目并选择添加新文件。选择此选项后,系统将提示您选择用于默认内容的文件模板。如果您正在使用针对 .NET 7.0.200 或更高版本的项目,您将在此获得最佳体验。

您也可以通过在 VS Code 中像往常一样创建文件并将其保存在包含项目文件的文件夹下,来将文件添加到项目中。默认情况下,添加到项目文件夹中的新文件将自动添加到项目中。

在项目视图中,您还可以看到项目的依赖项,包括项目引用包引用。在此版本的 C# Dev Kit 中,您无法修改依赖项。要向项目或包引用添加依赖项,可以使用 dotnet add 命令行工具。要添加包引用,请参阅dotnet add package 命令 - .NET CLI;要添加项目引用,请参阅dotnet add reference 命令 - .NET CLI。要移除引用,请使用 dotnet remove。您可以在如何移除包如何移除项目引用处阅读更多信息。

如果您想查看或编辑项目文件,请在解决方案管理器中选择项目节点,项目文件将在编辑器中打开。这与在解决方案管理器中选择文件的行为相同。

使用解决方案管理器,您还可以使用上下文菜单执行常见操作,例如构建重新构建清理。在解决方案管理器中选择解决方案节点或项目节点时,您将看到这些上下文菜单。这将构建/重新构建/清理所选项目及其依赖项。