Top-level statements是C# 9.0版本引入的语法特性，它的核心目标是简化控制台应用程序的入口点编写逻辑，让开发者不需要再显式定义Program类和静态Main方法，就可以直接编写可执行的程序代码。这个特性特别适合编写简单的测试脚本、小工具或者学习阶段的示例代码，能够减少大量冗余的模板代码。
Top-level statements的基本用法
使用Top-level statements时，只需要创建一个C#文件，直接在文件顶层编写要执行的代码即可，编译器会自动帮我们生成必要的Program类和Main方法。下面是一个最简单的示例：
// 直接使用Top-level statements编写控制台程序
using System;
Console.WriteLine("这是使用Top-level statements编写的程序");
int a = 10;
int b = 20;
Console.WriteLine($"a加b的结果是：{a + b}");
上面的代码不需要定义任何类和方法，直接运行就可以输出对应的内容。如果使用传统的写法，等效的代码是这样的：
using System;
namespace Demo
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("这是使用传统写法编写的程序");
int a = 10;
int b = 20;
Console.WriteLine($"a加b的结果是：{a + b}");
}
}
}
Top-level statements的进阶特性
支持方法定义
虽然Top-level statements不需要显式定义类，但是我们可以在顶层语句中定义局部函数，这些函数可以在后续的顶层代码中被调用：
using System;
// 定义局部函数
int Add(int x, int y)
{
return x + y;
}
int result = Add(5, 3);
Console.WriteLine($"计算结果：{result}");
支持命令行参数访问
如果需要获取命令行参数，可以直接使用args变量，这个变量是编译器自动生成的，类型是string[]：
using System;
// 遍历命令行参数
foreach (var arg in args)
{
Console.WriteLine($"接收到的参数：{arg}");
}
运行程序时传入参数，比如dotnet run -- 参数1 参数2，就可以输出对应的参数内容。
支持异步代码
顶层语句中可以直接编写异步代码，不需要像传统写法那样把Main方法标记为async：
using System;
using System.Threading.Tasks;
async Task DelayPrint()
{
await Task.Delay(1000);
Console.WriteLine("延迟1秒后输出");
}
await DelayPrint();
Top-level statements的适用场景和限制
Top-level statements最适合以下场景：
- 编写简单的控制台测试脚本，快速验证某个代码片段的逻辑
- 开发小型的工具类应用，不需要复杂的项目结构
- 初学者学习C#基础语法，减少模板代码的干扰
它也有一些限制需要注意：
- 一个项目中只能有一个文件使用Top-level statements，否则会出现多个入口点的编译错误
- 不能在顶层语句中定义类、结构体、枚举等类型，这些类型需要放在其他文件中定义
- 如果项目需要被其他项目引用作为类库，不适合使用Top-level statements，因为类库不需要入口点
两种写法的对比
我们可以通过下面的表格直观对比Top-level statements和传统写法的区别：
| 对比项 | Top-level statements | 传统写法 |
|---|---|---|
| 代码量 | 少，无冗余模板代码 | 多，需要定义Program类和Main方法 |
| 入口点数量 | 单文件唯一 | 可通过重载Main方法定义多个入口逻辑 |
| 适用场景 | 简单控制台应用、测试脚本 | 复杂控制台应用、类库项目 |
| 学习成本 | 低，直接写执行代码即可 | 高，需要理解类和静态方法的概念 |
总结
Top-level statements是C#为了简化控制台应用入口点推出的实用特性，它去掉了传统的Program类和Main方法的模板代码，让开发者可以更专注于业务逻辑本身。对于简单的控制台程序、测试脚本等场景，使用这个特性可以大幅提升开发效率，减少不必要的代码编写。不过在开发复杂的控制台应用或者类库项目时，还是建议根据需求选择合适的写法，充分发挥两种写法的各自优势。
C#Top-level_statements控制台应用程序入口点简化修改时间：2026-06-11 09:09:28