Skip to content

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] 包管理器安装:

winget install Microsoft.DotNet.SDK.10

必须选择 SDK (它包含全部内容),而不是只选“运行时”(它只能运行预先编译好的程序)。在 Linux 上,SDK 可在主流发行版的软件仓库中获得(例如在 Ubuntu 上使用 [sudo apt install dotnet-sdk-10.0] ;根据发行版的版本,你可能需要事先添加 Microsoft 安装文档中指定的软件仓库)。

安装完成后,打开一个 新的 终端,验证 [dotnet] 命令是否可用,并显示 SDK 的版本:

> dotnet --version
10.0.112

命令 [dotnet --list-sdks] 列出已安装的 SDK 版本(多个版本可以共存):

> dotnet --list-sdks
10.0.112 [C:\Program Files\dotnet\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] 文件:

// 第一个 C# 程序:单文件应用程序
Console.WriteLine("1st try with C# 14 and .NET 10");

然后运行它:

> dotnet run hello.cs
1st try with C# 14 and .NET 10

说明:

  • 第 1 行:一条注释。[//] 之后直到行尾的所有内容都会被编译器忽略;
  • 第 2 行:程序唯一的语句:它在屏幕上输出一行文本。与 2008 年的对应程序不同,该程序既没有名为 [Main] 的类,也没有同名的方法;我们将在第 3 章看到,它们是由编译器自行生成的;
  • [dotnet run hello.cs] 命令先编译程序,然后执行它。第一次执行需要几秒钟;只要文件保持不变,之后的执行几乎是即时的,因为编译结果存储在缓存中。

单文件应用程序适用于小型程序,我们的大多数示例都将使用它。放在文件开头的几个指令可以让你无需项目文件就能创建它们:

1
2
3
#:package MySqlConnector@2.4.0
#:property PublishAot=false
#:sdk Microsoft.NET.Sdk.Web
  • 指令 [#:package] 添加 NuGet 库(第 10 章);
  • 指令 [#:property] 设置编译属性(第 5 章);
  • [#:sdk] 指令选择另一个 SDK,例如用于 Web 应用程序的 SDK(第 12 章)。

在 Windows 上,如果 [.cs] 文件保存为 UTF-8(这是 VS Code 的默认设置),带重音符号的字符就能在终端中正确显示。

2.3.2. 将单文件应用程序转换为项目

当单文件应用程序规模变大(多个文件、测试、对其他项目的引用)时,就要把它转换为项目:

> dotnet project convert hello.cs -o hello

该命令创建一个名为 [hello] 的文件夹,其中包含程序的副本和一个名为 [hello.csproj]的项目文件:

1
2
3
4
> dir /s /b (list of files)
hello.cs
hello/hello.cs
hello/hello.csproj
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <PublishAot>true</PublishAot>
    <PackAsTool>true</PackAsTool>
    <UserSecretsId>hello-7b9b5da29436665281cfbf4b23ebf4fed6297358227418ac7d456d2e18d162bf</UserSecretsId>
  </PropertyGroup>

</Project>

项目文件继承了单文件应用程序的默认属性(例如 [PublishAot],用于准备提前编译为本机代码)。你可以删除不需要的属性。接下来我们将更详细地介绍项目。

2.4. 控制台项目

2.4.1. 创建项目

项目 是一个包含项目文件([.csproj])和源文件的文件夹。使用命令 [dotnet new] 加上 模板 的名称来创建它(此处为 [console],即控制台应用程序):

1
2
3
4
5
6
7
8
> dotnet new console -n FirstProgram
The template "Console App" was created successfully.

Processing post-creation actions...
Restoring csharp-oct-2026/02-installation/FirstProgram/FirstProgram.csproj:
  Determining projects to restore...
  Restored csharp-oct-2026/02-installation/FirstProgram/FirstProgram.csproj (in 127 ms).
Restore succeeded.

该命令创建了一个名为 [FirstProgram] 的文件夹,其中包含两个文件。项目文件 [FirstProgram.csproj] 内容如下:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>
  • 第 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] 文件的内容替换为如下内容:

// [FirstProgram] 项目的主程序
Console.WriteLine("1st try with a C# 14 / .NET 10 project");

2.4.2. 编译与执行

在项目文件夹中输入命令 [dotnet build],即可编译项目:

> dotnet build
  Determining projects to restore...
  All projects are up-to-date for restore.
  FirstProgram -> csharp-oct-2026/02-installation/FirstProgram/bin/Debug/net10.0/FirstProgram.dll

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:00:01.56
  • 第 2 行:该命令首先 还原 项目,也就是下载项目所依赖的 NuGet 包(此处没有);
  • 第 4 行:编译的结果是一个 DLL,即 [FirstProgram.dll] 文件 ,位于项目的 [bin/Debug/net10.0] 文件夹中。在 Windows 上,显示的路径是 Windows 路径([bin\Debug\net10.0\FirstProgram.dll])。

此时 [bin/Debug/net10.0] 文件夹包含以下文件:

1
2
3
4
5
6
> dir bin\Debug\net10.0 (list of files)
FirstProgram
FirstProgram.deps.json
FirstProgram.dll
FirstProgram.pdb
FirstProgram.runtimeconfig.json
  • [FirstProgram.dll] 包含编译后的代码(中间代码 IL);
  • [FirstProgram] (在 Windows 上是 [FirstProgram.exe])是一个小型启动器,它启动 .NET 平台并让其执行该 DLL;
  • [FirstProgram.pdb] 包含调试器使用的信息;
  • 两个 [.json] 文件描述了程序的依赖项以及运行它所需的 .NET 版本。

你可以直接运行启动器:

> FirstProgram
1st try with a C# 14 / .NET 10 project

不过,最常用的是 [dotnet run] 命令;它会在必要时编译项目,然后运行它:

> dotnet run
1st try with a C# 14 / .NET 10 project

与 2008 年一样,有两种构建配置:Debug (默认,带有调试信息)和 Release (经过优化,用于生产环境),通过选项 [-c Release] 来选择:[dotnet build -c Release] 会在 [bin/Release/net10.0] 文件夹中生成程序。[obj] 文件夹包含编译的中间文件。[bin] 和 [obj] 文件夹可以放心删除:它们会在下次编译时重新创建。

2.5. 包含多个项目的解决方案

2.5.1. 创建解决方案

解决方案 将多个项目组合在一起。它使你可以在编辑器中同时打开这些项目并一起编译。让我们在包含 [FirstProgram] 项目的文件夹中创建一个解决方案:

> dotnet new sln -n 02-installation
The template "Solution File" was created successfully.

然后把项目添加进去:

> dotnet sln add FirstProgram
Project `FirstProgram/FirstProgram.csproj` added to the solution.

再添加第二个项目 [TwoHands],其内容我们稍后再看:

> dotnet sln add TwoHands
Project `TwoHands/TwoHands.csproj` added to the solution.

命令 [dotnet sln list] 列出解决方案中的项目:

1
2
3
4
5
> dotnet sln list
Project(s)
----------
FirstProgram/FirstProgram.csproj
TwoHands/TwoHands.csproj

解决方案文件 [02-installation.slnx] 内容如下:

1
2
3
4
<Solution>
  <Project Path="TwoHands/TwoHands.csproj" />
  <Project Path="FirstProgram/FirstProgram.csproj" />
</Solution>

这是一个非常简单的 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]:

1
2
3
4
5
6
7
8
9
namespace TwoHands;

class P1
{
    static void Main(string[] args)
    {
        Console.WriteLine("Main of class P1");
    }
}

以及 [P2] 类:

1
2
3
4
5
6
7
8
9
namespace TwoHands;

class P2
{
    static void Main(string[] args)
    {
        Console.WriteLine("Main of class P2");
    }
}

如果不采取任何额外措施就编译该项目,会得到一个错误:

> dotnet build
...\TwoHands\P1.cs(5,17): error CS0017: Program has more than one entry point defined. Compile with /main to specify the type that contains the entry point. 

编译器不知道哪个 [Main] 方法才是程序的入口点。我们在项目文件中使用 [StartupObject] 属性来指定:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <!-- 执行其 Main 方法的类 -->
    <StartupObject>TwoHands.P2</StartupObject>
  </PropertyGroup>

</Project>
  • 第 9 行:被执行的 [Main] 方法属于类 [TwoHands.P2] (完整的类名,包含命名空间)。

结果:

> dotnet run
Main of class 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 的方法见附录。