C# 程序的结构

C# 程序由一个或多个文件（.cs 文件）组成。

每个文件包含 0 个或多个命名空间。

命名空间包含类、结构、接口、枚举、委托等类型或其他命名空间。

在写本笔记时（2025年5月），.Net 正式发布的最新版本是 .Net 9.0 版本。

经典的 C# 程序结构：

使用了顶级语句（top-level statements）的 C# 程序结构：

程序入口 Main 方法

Main 方法是 C# 应用程序的入口点。 Main 方法是应用程序启动后调用的第一个方法。

C# 程序中只能有一个入口点。 如果多个类包含 Main 方法，必须使用 StartupObject 编译器选项来编译程序，以指定将哪个 方法用作入口点。

Main 方法的签名可以为如下之一：

Main 入口方法的特点：

• 必须在类或结构体里声明
• 必须是静态（static）的
• 不管访问修饰符（如 public、internal、private 等，但不能为 file）
• 返回类型为 void、int、Task 或 Task<int> 之一

WinForm 程序也有 Main 方法。用 VS2022 创建一个 WinForm 程序，可以看到类似如下代码：

WPF 程序的入口是隐式的，由编译器自动生成。但可以手动修改项目文件，为程序加上入口 Main 方法。网上可以找到一些介绍文章，亲测可以实现。

顶级语句（top-level statements）

使用顶级语句，可以最大程度地减少（一个最少代码程序）必须编写的代码。

使用顶级语句时，编译器自动生成 Program 类，里面有程序的入口，名字不是 Main。它是编译器的实现细节，外部代码不能直接引用。

使用顶级语句时，有以下的要求：

• 仅能有一个顶级文件（该文件里有顶级语句）。
• 没有其它入口点，你自己指定的 Main 方法不管用，编译器只使用自己生成的入口。
• 顶级文件中的 using 指令（using directives，比如 using System.Text;）要放在前面。
• 命名空间和类型定义要写在顶级语句的后面。

使用顶级语句时，也可以完成经典 Main 方法的功能：

• 可以引用 args 变量来访问输入的任何命令行参数。
• 可以通过使用 await 来调用异步方法。
• 可以 return 一个 int 返回值。

例如，可以有类似这样的一些代码：

另外，可以在其它地方使用 Environment.CommandLine 或
Environment.GetCommandLineArgs 来访问命令行参数。

VS2022 在通过模板创建项目时，有是否禁用顶级语句的选项可选。

如果用命令行 dotnet new 来创建项目，可以使用 --use-program-main 选项来禁用顶级语句。例如：dotnet new console --use-program-main。

编译器，会根据顶级语句里面是否有 await 或 return 语句，生成匹配的入口。 入口的签名如下（名称不是Main，只是为了说明）：

有 await 和 return

签名 static async Task<int> Main(string[] args)

有 await

签名 static async Task Main(string[] args)

有 return

签名 static int Main(string[] args)

无 await 且无 return

签名 static void Main(string[] args)

结束语

C# 这几年更新较快，引入不少新特性，带来了更多便利。