在C#的传统控制台程序开发中，我们需要先定义Program类，再在类中编写静态的Main方法作为程序入口，这种固定结构对于小型测试程序或者简单工具来说会显得冗余。顶级语句的出现就是为了解决这个问题，让开发者可以直接在代码文件的最顶层编写可执行的代码逻辑，编译器会自动生成隐藏的Main方法包装这些代码。
传统Main入口的写法
我们先来看没有使用顶级语句时的标准控制台程序入口代码，这是很多C#初学者最开始接触的结构：
using System;
namespace Demo
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Hello World");
Console.WriteLine($"传入的参数数量：{args.Length}");
}
}
}
这段代码中，我们需要定义命名空间、类、静态Main方法三个层级的结构，即使只是输出一行内容，也需要写这么多样板代码。
顶级语句的基本用法
使用顶级语句后，上面的代码可以简化为如下形式：
using System;
Console.WriteLine("Hello World");
Console.WriteLine($"传入的参数数量：{args.Length}");
可以看到我们完全省略了命名空间、Program类、Main方法的定义，直接编写要执行的代码即可。编译器会在编译阶段自动生成包含Main方法的Program类，将顶层的代码放到Main方法内部，同时自动处理args参数的传递。
顶级语句的使用规则
顶级语句虽然简化了写法，但也有一些必须遵守的规则：
- 一个项目中只能有一个文件包含顶级语句，否则编译器会报重复入口的错误
- 顶级语句必须放在using指令之后，任何类型定义、命名空间定义之前
- 顶级语句中可以定义方法、类、结构体等类型，但是这些定义必须放在顶级语句的可执行代码之后
- 顶级语句中可以直接使用args变量获取程序启动时的命令行参数，不需要自己定义
在顶级语句中定义方法示例
如果需要在顶级语句中拆分逻辑，可以定义局部方法，示例如下：
using System;
SayHello("C#");
PrintSum(1, 2);
void SayHello(string name)
{
Console.WriteLine($"Hello {name}");
}
void PrintSum(int a, int b)
{
Console.WriteLine($"{a} + {b} = {a + b}");
}
顶级语句的适用场景
顶级语句并不是要完全替代传统的Main方法写法，它更适合以下场景：
- 编写小型的控制台测试程序，快速验证某个API的用法
- 开发简单的命令行小工具，不需要复杂的项目结构
- 初学者入门C#时，减少样板代码带来的理解负担，快速看到代码执行效果
如果是大型的企业级项目，或者需要复杂的程序入口逻辑，还是建议使用传统的Main方法写法，结构更清晰，也更符合大型项目的代码规范。
两种写法的对比
我们可以通过下面的表格更直观地看到两种入口写法的差异：
| 对比项 | 传统Main入口 | 顶级语句 |
|---|---|---|
| 代码层级 | 命名空间-类-方法三层结构 | 无额外层级，直接写可执行代码 |
| 样板代码量 | 较多，需要定义类和方法框架 | 极少，只需要写核心逻辑 |
| 适用项目规模 | 所有规模项目都适用 | 仅适用于小型、简单项目 |
| args参数获取 | 需要定义在Main方法参数中 | 直接使用预定义的args变量 |
注意事项
在使用顶级语句的时候，还要注意不要在一个文件里同时写顶级语句和显式的Main方法，否则编译器会优先使用显式的Main方法，顶级语句的代码不会被执行。另外如果项目中存在多个文件，只有包含顶级语句的那个文件会作为程序入口，其他文件中的顶级语句是不被允许的。
总的来说，顶级语句是C#为了简化小型程序开发引入的实用特性，合理运用可以大幅提升编码效率，但是也要根据项目实际情况选择是否使用，不要盲目追求简化而忽略代码的可维护性。