C# 程序的常规结构 — 命名空间、类型、入口点与表达式

不少人刚装好.NET SDK，输入dotnet new console后，会产生这样的疑问：Program.cs里怎么没有Main方法？namespace去哪儿了？还有那些class、struct、interface，它们之间到底是什么关系？这篇文章就好比C#程序的“骨架说明书”，会从顶层到底层，把一个.cs文件里能看到的所有结构元素串联起来。

本文基于 Microsoft Learn 官方文档整理。

1. 两大选择：基于文件 vs 基于项目、顶级语句 vs Main 方法
2. 核心构建基块：命名空间、类型（类/结构/接口/枚举/委托）的层级关系
3. 表达式与语句：程序运行时的最小执行单元

一、两大基础选择

在创建 C# 程序之前，首先要做两个决策：

1.1 基于文件还是基于项目？

维度	基于文件的应用	基于项目的应用
引入版本	C# 14 / .NET 10	所有版本
项目文件	无需.csproj	需要.csproj
运行方式	​dotnet run hello-world.cs	​dotnet build​+dotnet run
多文件支持	单文件	天然支持多文件
适用场景	小型命令行工具、原型、试验	多文件项目、复杂生成配置

目录结构对比：

 基于文件：
 my-app/
 └── hello-world.cs
 ​
 基于项目：
 my-app/
 ├── my-app.csproj
 ├── Program.cs
 ├── Models/
 │   └── Person.cs
 └── Services/
     └── GreetingService.cs

关键点： 基于文件的应用可以随时用 dotnet project convert 转换为基于项目的应用，进可攻退可守。

1.2 顶级语句还是 Main 方法？

入口点样式	写法	特点
顶级语句	文件顶部直接写代码	​dotnet new console默认样式，简洁
显式 Main 方法	​static void Main(string[] args)	传统风格，明确入口点

限制： 一个项目中只能有一个文件使用顶级语句，且入口点从该文件的第一行开始。

 // 顶级语句 — 无需 class 和 Main 包裹
 Console.WriteLine("Hello, World!");
 ​
 // 在 Unix 下甚至可以加 shebang 直接执行
 #!/usr/bin/env dotnet
 Console.WriteLine("Hello, World!");

 // 显式 Main 方法 — 传统入口
 namespace YourNamespace;
 ​
 class Program
 {
     static void Main(string[] args)
     {
         Console.WriteLine("Hello, World!");
     }
 }

两种入口点样式支持相同的功能，选哪种纯粹是风格偏好。

二、核心构建基块：完整的程序骨架

C# 程序由以下层级构成：

 程序
  └── 命名空间（namespace）
       └── 类型（class / struct / interface / enum / delegate）
            └── 成员（字段、属性、方法、事件...）
                 └── 语句（statement）
                      └── 表达式（expression）

2.1 完整示例

 // 顶级语句作为入口点
 Console.WriteLine("Hello, World!");
 ​
 // 命名空间：组织类型的容器
 namespace YourNamespace
 {
     // 类：引用类型，封装数据和行为
     class YourClass
     {
     }
 ​
     // 结构：值类型，轻量级数据载体
     struct YourStruct
     {
     }
 ​
     // 接口：定义行为契约
     interface IYourInterface
     {
     }
 ​
     // 委托：类型安全的方法指针
     delegate int YourDelegate();
 ​
     // 枚举：命名常量集合
     enum YourEnum
     {
     }
 }

各类型定位速查：

类型	关键字	值/引用	用途
类	​class	引用类型	封装数据和行为，面向对象核心
结构	​struct	值类型	轻量级数据载体，栈分配
接口	​interface	—	定义行为契约，不含实现
枚举	​enum	值类型	命名常量集合
委托	​delegate	引用类型	类型安全的方法引用

划重点： class​ 和 struct​ 的核心区别是值类型 vs 引用类型。struct​ 在赋值时复制全部数据，class 只复制引用。这直接影响性能和语义，不可轻视。

三、生成和运行

C# 是编译型语言 —— 源代码先编译为 IL（中间语言），再由 .NET 运行时 JIT 编译为机器码。

命令	作用	适用
​dotnet build	编译项目	基于项目的应用
​dotnet run	编译 + 运行（一步到位）	基于项目的应用
​dotnet run hello-world.cs	直接编译并运行单个文件	基于文件的应用

四、表达式与语句

表达式和语句是程序运行时的最小执行单元。

4.1 表达式：产生值的东西

表达式	类型	说明
​42	字面值	最简单的表达式
​x + y	算术运算	运算符连接操作数
​Math.Max(a, b)	方法调用	调用有返回值的方法
​condition ? a : b	条件表达式	三元运算
​new Person("John")	对象创建	new 表达式

4.2 语句：执行操作的东西

语句通常以分号 ; 结尾。

语句	类别	说明
​int x;	声明语句	声明变量
​int x = 42;	声明语句	声明并初始化
​Console.WriteLine("Hello");	方法调用语句	调用方法（忽略返回值）
​if (condition) { ... }	条件语句	分支控制
​return result;	return 语句	方法返回

4.3 语句和表达式的关系

语句常常包含表达式，表达式可以嵌套：

 var maxResult = Math.Max(a, b) + Math.Max(c, d);

拆解：

1. ​Math.Max(a, b)​ 和 Math.Max(c, d) 是两个方法调用表达式
2. ​+ 将两个表达式的结果相加，产生一个新表达式
3. ​var maxResult = ... 是一条声明语句，将表达式的结果赋给变量

一句话区分： 表达式产生值，语句执行操作。Math.Max(a, b)​ 是表达式（有返回值），Console.WriteLine(...) 是语句（重在副作用）。

五、程序结构速查图

 ┌─────────────────────────────────────────┐
 │  入口点                                   │
 │  · 顶级语句：文件第一行直接写代码           │
 │  · 或 static void Main(string[] args)    │
 ├─────────────────────────────────────────┤
 │  namespace 命名空间（可选）                │
 │  ├── class 类                            │
 │  ├── struct 结构                         │
 │  ├── interface 接口                      │
 │  ├── enum 枚举                           │
 │  └── delegate 委托                       │
 ├─────────────────────────────────────────┤
 │  类型成员                                 │
 │  └── 字段、属性、方法、事件、索引器...      │
 ├─────────────────────────────────────────┤
 │  可执行代码                               │
 │  └── 语句（包含表达式）                    │
 └─────────────────────────────────────────┘

最后

C#程序结构看似层级繁多，实则理解起来不过入口点、命名空间、类型、成员、语句这些。新手最易困惑的是“顶级语句为何没有Main”——其实是编译器自动生成了，你所见的顶层代码最终会被封装进一个隐式的

$

方法里。语法糖只是为了减少模板代码的编写，底层模型并未改变。

‍