2. 搭建开发环境
2008 年,我们安装的是 Visual C# 2008 Express,其中包含 .NET 3.5 框架、SQL Compact Server 数据库管理系统和 MSDN 文档,然后通过图形向导创建项目。如今,开发环境由两个相互独立的组件构成:
- .NET SDK (“Software Development Kit”,即软件开发工具包):包含编译器、运行时平台、库和 [dotnet] 命令,该命令让你可以在命令行中完成所有操作(创建、编译、运行、测试和发布程序);
- 一个 编辑器 或一个 IDE (集成开发环境):[VS Code] 加上 [C# Dev Kit] 扩展,或 [Visual Studio 2026],或 [JetBrains Rider]。编辑器以 SDK 为基础。
本文档的所有操作都使用 [dotnet] 命令:无论选择哪种编辑器,它在 Windows、Linux 和 macOS 上的工作方式都相同。
2.1. .NET 10 SDK
2.1.1. 安装
.NET 10 SDK 可从 https://dotnet.microsoft.com/download/dotnet/10.0下载。在 Windows 上,也可以在终端(PowerShell 或命令提示符)中使用 [winget] 包管理器安装:
必须选择 SDK (它包含全部内容),而不是只选“运行时”(它只能运行预先编译好的程序)。在 Linux 上,SDK 可在主流发行版的软件仓库中获得(例如在 Ubuntu 上使用 [sudo apt install dotnet-sdk-10.0] ;根据发行版的版本,你可能需要事先添加 Microsoft 安装文档中指定的软件仓库)。
安装完成后,打开一个 新的 终端,验证 [dotnet] 命令是否可用,并显示 SDK 的版本:
命令 [dotnet --list-sdks] 列出已安装的 SDK 版本(多个版本可以共存):
确切的版本(此处为 [10.0.112])取决于安装日期:Microsoft 每月发布一次热修复更新。SDK 的所有 10.0.x 版本都适用于本文档。[dotnet --info] 命令提供更详细的信息(操作系统、SDK 的位置、已安装运行时平台的版本)。
2.1.2. dotnet 命令
[dotnet] 命令包含许多子命令。以下是我们将要使用的子命令:
命令 | 作用 |
[dotnet run file.cs] | 编译并运行单文件应用程序 |
[dotnet new console -n Name] | 在 [Name] 文件夹中创建控制台项目(其他模板:[classlib]、[mstest]、[web]……) |
[dotnet build] | 编译当前文件夹中的项目 |
[dotnet run] | (必要时)编译并运行当前文件夹中的项目 |
[dotnet test] | 运行单元测试(第 6 章) |
[dotnet new sln] | 创建解决方案(将多个项目组合在一起的文件) |
[dotnet sln add Project] | 将项目添加到解决方案 |
[dotnet add package Name] | 向项目添加 NuGet 库(第 10 章和第 11 章) |
[dotnet add reference ../Other] | 添加对另一个项目的引用(第 6 章) |
[dotnet publish] | 准备程序以便部署 |
不属于平台的库以 NuGet 包的形式分发,从 https://www.nuget.org下载,并存储在计算机的 [%USERPROFILE%\.nuget\packages] 文件夹中。2008 年,我们把库(Spring.NET、NUnit 和 MySQL 连接器)的 DLL 文件复制到项目内的 [lib] 文件夹中;如今,项目声明它所需要的包,由 [dotnet] 命令下载这些包。
2.2. 编辑器
2.2.1. VS Code
VS Code 是一款免费的跨平台编辑器。要使用 C# 编程,需要添加 Microsoft 的 C# Dev Kit 扩展(进入“扩展”菜单并搜索“C# Dev Kit”),它同时会安装 C# 扩展。它提供:
- 语法高亮、代码补全和工具提示帮助;
- 输入时的错误检测;
- 代码导航(F12:转到定义);
- 解决方案资源管理器(“Solution Explorer”视图);
- 执行和调试(F5);
- 运行单元测试(“Testing”视图)。
在 VS Code 中,打开包含程序的 文件夹 (“File / Open Folder”),例如包含本文档示例的 [csharp-oct-2026] 文件夹。内置终端(“Terminal / New Terminal”)让你无需离开编辑器即可输入 [dotnet] 命令。
2.2.2. Visual Studio 2026
在 Windows 上,你可能更愿意使用 Visual Studio 2026,它是原课程所用 Visual Studio 2008 的后继版本。其 Community 版对个人、教育机构和开源项目免费。从 https://visualstudio.microsoft.com安装,选择“.NET 桌面开发”工作负载(第 13 章还需要“ASP.NET 和 Web 开发”)。Visual Studio 可以直接打开示例中的 [.slnx] 解决方案和 [.csproj] 项目(“File / Open / Project/Solution”),并使用 [Ctrl-F5] (不调试)或 [F5] (调试)运行它们,与 2008 年完全一样。
第三种选择是 JetBrains Rider,它对非商业用途免费。
在本文档的其余部分,各步骤都使用 [dotnet] 命令来描述,无论使用哪种编辑器,它都会产生相同的结果。
2.3. 第一个程序:单文件应用程序
2.3.1. 程序
从 .NET 10 开始,C# 程序可以是单个 [.cs] 文件,不需要项目文件。这称为“基于文件的应用”(file-based app)。让我们创建如下 [hello.cs] 文件:
然后运行它:
说明:
- 第 1 行:一条注释。[//] 之后直到行尾的所有内容都会被编译器忽略;
- 第 2 行:程序唯一的语句:它在屏幕上输出一行文本。与 2008 年的对应程序不同,该程序既没有名为 [Main] 的类,也没有同名的方法;我们将在第 3 章看到,它们是由编译器自行生成的;
- [dotnet run hello.cs] 命令先编译程序,然后执行它。第一次执行需要几秒钟;只要文件保持不变,之后的执行几乎是即时的,因为编译结果存储在缓存中。
单文件应用程序适用于小型程序,我们的大多数示例都将使用它。放在文件开头的几个指令可以让你无需项目文件就能创建它们:
- 指令 [#:package] 添加 NuGet 库(第 10 章);
- 指令 [#:property] 设置编译属性(第 5 章);
- [#:sdk] 指令选择另一个 SDK,例如用于 Web 应用程序的 SDK(第 12 章)。
在 Windows 上,如果 [.cs] 文件保存为 UTF-8(这是 VS Code 的默认设置),带重音符号的字符就能在终端中正确显示。
2.3.2. 将单文件应用程序转换为项目
当单文件应用程序规模变大(多个文件、测试、对其他项目的引用)时,就要把它转换为项目:
该命令创建一个名为 [hello] 的文件夹,其中包含程序的副本和一个名为 [hello.csproj]的项目文件:
项目文件继承了单文件应用程序的默认属性(例如 [PublishAot],用于准备提前编译为本机代码)。你可以删除不需要的属性。接下来我们将更详细地介绍项目。
2.4. 控制台项目
2.4.1. 创建项目
项目 是一个包含项目文件([.csproj])和源文件的文件夹。使用命令 [dotnet new] 加上 模板 的名称来创建它(此处为 [console],即控制台应用程序):
该命令创建了一个名为 [FirstProgram] 的文件夹,其中包含两个文件。项目文件 [FirstProgram.csproj] 内容如下:
- 第 1 行:项目使用 SDK [Microsoft.NET.Sdk],即用于控制台应用程序和库的 SDK;
- 第 4 行:项目生成的是可执行文件([Exe])而不是库;
- 第 5 行:目标平台是 .NET 10([net10.0]);
- 第 6 行:最常用的命名空间([System]、[System.IO]、[System.Linq]……)会被自动导入所有文件(第 3 章);
- 第 7 行:编译器会检查 null 引用的使用情况,并对潜在的错误发出警告(第 3 章和第 4 章)。
2008 年的文件用大约一百行描述了项目中的每个源文件、库引用以及 Debug/Release 配置。当前的项目文件只包含与默认值不同的设置:文件夹中所有的 [.cs] 文件都属于该项目。
我们把生成的 [Program.cs] 文件的内容替换为如下内容:
2.4.2. 编译与执行
在项目文件夹中输入命令 [dotnet build],即可编译项目:
- 第 2 行:该命令首先 还原 项目,也就是下载项目所依赖的 NuGet 包(此处没有);
- 第 4 行:编译的结果是一个 DLL,即 [FirstProgram.dll] 文件 ,位于项目的 [bin/Debug/net10.0] 文件夹中。在 Windows 上,显示的路径是 Windows 路径([bin\Debug\net10.0\FirstProgram.dll])。
此时 [bin/Debug/net10.0] 文件夹包含以下文件:
- [FirstProgram.dll] 包含编译后的代码(中间代码 IL);
- [FirstProgram] (在 Windows 上是 [FirstProgram.exe])是一个小型启动器,它启动 .NET 平台并让其执行该 DLL;
- [FirstProgram.pdb] 包含调试器使用的信息;
- 两个 [.json] 文件描述了程序的依赖项以及运行它所需的 .NET 版本。
你可以直接运行启动器:
不过,最常用的是 [dotnet run] 命令;它会在必要时编译项目,然后运行它:
与 2008 年一样,有两种构建配置:Debug (默认,带有调试信息)和 Release (经过优化,用于生产环境),通过选项 [-c Release] 来选择:[dotnet build -c Release] 会在 [bin/Release/net10.0] 文件夹中生成程序。[obj] 文件夹包含编译的中间文件。[bin] 和 [obj] 文件夹可以放心删除:它们会在下次编译时重新创建。
2.5. 包含多个项目的解决方案
2.5.1. 创建解决方案
解决方案 将多个项目组合在一起。它使你可以在编辑器中同时打开这些项目并一起编译。让我们在包含 [FirstProgram] 项目的文件夹中创建一个解决方案:
然后把项目添加进去:
再添加第二个项目 [TwoHands],其内容我们稍后再看:
命令 [dotnet sln list] 列出解决方案中的项目:
解决方案文件 [02-installation.slnx] 内容如下:
这是一个非常简单的 XML 文件。自 .NET 10 起,这就是解决方案的默认格式([.slnx])。Visual Studio 2008 使用的旧 [.sln] 格式要冗长得多;它在现有项目中仍然可以见到,并且仍可使用 [dotnet new sln --format sln] 命令来创建它。
在解决方案文件夹中,命令 [dotnet build] 会编译解决方案中的所有项目。要运行某个特定项目,请进入它的文件夹并输入 [dotnet run],或者使用 [--project] 选项:[dotnet run --project FirstProgram]。
2.5.2. 包含多个 Main 方法的项目
2008 年的课程演示过,一个项目可以包含多个类,每个类都有一个名为 [Main] 的静态方法,并且必须指定执行哪一个。现在仍然可以这样做。项目 [TwoHands] 包含两个类。类 [P1]:
以及 [P2] 类:
如果不采取任何额外措施就编译该项目,会得到一个错误:
编译器不知道哪个 [Main] 方法才是程序的入口点。我们在项目文件中使用 [StartupObject] 属性来指定:
- 第 9 行:被执行的 [Main] 方法属于类 [TwoHands.P2] (完整的类名,包含命名空间)。
结果:
使用顶级语句(第 3 章)时,这个问题就不复存在了:项目中的单个文件可以包含这些语句,该文件即为入口点。
2.6. 本文档中的示例
要运行本文档中的示例:
- 下载 [csharp-oct-2026] 文件夹(链接位于文档开头);
- 在 VS Code 中打开它(“File / Open Folder”),或者针对某个具体章节,在 Visual Studio 中打开该章节的解决方案([.slnx]);
- 在位于某章文件夹的终端中,使用 [dotnet run name.cs] 运行单文件应用程序,或在项目文件夹中使用 [dotnet run] 运行项目。
第 10 章和第 11 章使用 MySQL 数据库;使用 [Laragon] 安装 MySQL 的方法见附录。