EssentialCSharp - C#本质论

本项目包含《C# 12.0本质论》的源代码，2024年清华大学出版社出版。

中文版主页请访问周靖的博客

英文版在线手稿请访问EssentialCSharp.com

在英文版（print edition）中发现并纠正了不少疏漏，已提供英文版勘误。

中文版购买链接

• 京东官方
• 当当网

中英文版配套资源（含试读PDF）备用下载地址

• 百度网盘
• 也可以访问中文版主页从本地下载（已完成）

要求

• .NET - 该项目当前经过.NET 8.0、7.0和6.0的测试。
• Visual Studio - 已集成.NET Core，这是我们主推的IDE，用它可以方便地入门。
• Git - 虽然不是必需的，但它是一个可以快速下载此代码仓库的好工具。如果不喜欢使用命令行，建议使用Visual Studio自带的Git功能，或者使用第三方工具，例如GitKraken 。

运行代码

Visual Studio

1. EssentialCSharp.sln 是项目的主解决方案，请使用Visual Studio打开。
2. 打开解决方案文件后，选择生成->生成解决方案，使用Visual Studio编译代码。
   • 注意：在执行源代码之前，需要将和当前章对应的项目设为启动项目。例如，要执行第1章的示例，那么应该右键单击Chapter01项目，然后选择“设为启动项目”。如果选择一个目标章作为启动项目，但输入其他章的代码清单编号，那么会导致异常，并显示消息：“不存在和代码清单...对应的章”，“不存在代码清单...”或者“异常”。
3. 要运行代码，请按F5或选择调试->开始调试。
4. 运行后，程序将提示输入要执行的代码清单编号（例如，18.33）。
   • 注意：如前所述，只能输入本书合法的代码清单编号。

Dotnet CLI

1. 从本地终端导航到EssentialCSharp的根目录（根目录是包含EssentialCSharp.sln文件的目录）。

2. 从该根目录运行以下命令以还原和构建所有项目：

   dotnet restore
   dotnet build

3. 要运行代码，请首先导航到希望执行的那个章节所在的项目目录。例如，要执行第1章的示例，需要先导航到Chapter01目录（例如：cd src/Chapter01）。

4. 然后使用dotnet run命令启动程序，并按照提示输入要执行的代码清单编号。

   • 注意：只能输入在当前运行的项目（本例是Chapter01）中存在的代码清单编号。

5. 还可以使用dotnet run -p <projectfile>命令，其中project file是要执行的项目文件的路径（例如，dotnet run -p .\src\Chapter01\Chapter01.csproj）。执行时，程序将提示要执行哪个代码清单。

.NET CLI工具的文档可以在这里找到：https://learn.microsoft.com/zh-cn/dotnet/core/tools/

测试

注：中文版请忽略。

许多代码清单都有相应的单元测试。

在Visual Studio中，要执行测试，请打开测试项目

并导航到与您要执行的代码清单对应的测试。然后，在测试方法上右键单击，选择运行测试（Ctrl+R，T）或调试测试（Ctrl+R，Ctrl+T）。或者，打开Test Explorer窗口，并从那里运行一些或所有测试（更多信息）。

在dotnet test中，要在所有项目中运行所有测试，请在根EssentialCSharp目录中的命令提示符上运行dotnet test。要运行单个项目的测试，请在要执行的测试的测试项目的测试目录中使用dotnet test命令。

阅读源代码

在源代码中，有一些可能与在书中查看源代码时看起来不同的地方。这是因为即使书中的示例直接来自这个存储库，但并非所有代码都在书中原样显示。

一些注意事项：

当代码中有匹配的#region INCLUDE和#endregion INCLUDE标签时，在这两个标签之间的是在本书中能够看到的源代码。

当代码中有匹配的#region EXCLUDE和#endregion EXCLUDE标签时，即使这些标签在两个INCLUDE标签之间，此部分也会在书中省略，并用// ...替换，目的是让您将重点放在当前讲解的主题上。

此外，任何以// EXCLUDE结尾的行都在书中省略了。

问题/错误

如果有任何问题或发现任何错误，请随时打开本书中文版Git、Pull Request或Issue。

另外，请访问本书中文版主页，获取最新资讯、下载和勘误。

祝您编码愉快