在 VS Code 中试用

项目管理

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

注意:在 VS Code 中使用解决方案资源管理器视图需要 C# 开发工具包扩展

解决方案资源管理器

新的 C# 开发工具包扩展在主侧边栏中包含一个新视图,即解决方案资源管理器。此视图提供应用程序、其解决方案及其项目的结构化视图,以实现轻松的集中式项目管理。当您打开包含 .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: 打开解决方案命令来调用该命令。

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

解决方案文件夹

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

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# 开发工具包中,您无法修改依赖项。要向项目或包引用添加依赖项,您可以使用 dotnet add 命令行工具。要添加包引用,请参阅 dotnet add package 命令 - .NET CLI;要添加项目引用,请参阅 dotnet add reference 命令 - .NET CLI。要删除引用,请使用 dotnet remove。您可以在 如何删除包引用如何删除包 中阅读更多信息。

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

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