很多人刚装好 .NET SDK，敲下 dotnet new console 之后会困惑：Program.cs 里为什么没有 Main 方法？namespace 去哪了？那些 class、struct、interface 又是什么关系？这篇就是 C# 程序的"骨架说明书"------从顶层到底层，把一个 .cs 文件里能看到的所有结构元素串一遍。
本文基于 Microsoft Learn 官方文档整理。
- 两大选择：基于文件 vs 基于项目、顶级语句 vs Main 方法
- 核心构建基块：命名空间、类型（类/结构/接口/枚举/委托）的层级关系
- 表达式与语句：程序运行时的最小执行单元
一、两大基础选择
在创建 C# 程序之前，首先要做两个决策：
1.1 基于文件还是基于项目？
| 维度 | 基于文件的应用 | 基于项目的应用 |
|---|---|---|
| 引入版本 | C# 14 / .NET 10 | 所有版本 |
| 项目文件 | 无需.csproj |
需要.csproj |
| 运行方式 | dotnet run hello-world.cs |
dotnet build+dotnet run |
| 多文件支持 | 单文件 | 天然支持多文件 |
| 适用场景 | 小型命令行工具、原型、试验 | 多文件项目、复杂生成配置 |
目录结构对比：
csharp
基于文件：
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) |
传统风格，明确入口点 |
限制： 一个项目中只能有一个文件使用顶级语句，且入口点从该文件的第一行开始。
csharp
// 顶级语句 --- 无需 class 和 Main 包裹
Console.WriteLine("Hello, World!");
// 在 Unix 下甚至可以加 shebang 直接执行
#!/usr/bin/env dotnet
Console.WriteLine("Hello, World!");
csharp
// 显式 Main 方法 --- 传统入口
namespace YourNamespace;
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Hello, World!");
}
}两种入口点样式支持相同的功能，选哪种纯粹是风格偏好。
二、核心构建基块：完整的程序骨架
C# 程序由以下层级构成：
csharp
程序
└── 命名空间（namespace）
└── 类型（class / struct / interface / enum / delegate）
└── 成员（字段、属性、方法、事件...）
└── 语句（statement）
└── 表达式（expression）2.1 完整示例
csharp
// 顶级语句作为入口点
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 语句和表达式的关系
语句常常包含表达式，表达式可以嵌套：
css
var maxResult = Math.Max(a, b) + Math.Max(c, d);拆解：
Math.Max(a, b)和Math.Max(c, d)是两个方法调用表达式+将两个表达式的结果相加，产生一个新表达式var maxResult = ...是一条声明语句，将表达式的结果赋给变量
一句话区分： 表达式产生值，语句执行操作。
Math.Max(a, b) 是表达式（有返回值），Console.WriteLine(...)是语句（重在副作用）。
五、程序结构速查图
csharp
┌─────────────────────────────────────────┐
│ 入口点 │
│ · 顶级语句：文件第一行直接写代码 │
│ · 或 static void Main(string[] args) │
├─────────────────────────────────────────┤
│ namespace 命名空间（可选） │
│ ├── class 类 │
│ ├── struct 结构 │
│ ├── interface 接口 │
│ ├── enum 枚举 │
│ └── delegate 委托 │
├─────────────────────────────────────────┤
│ 类型成员 │
│ └── 字段、属性、方法、事件、索引器... │
├─────────────────────────────────────────┤
│ 可执行代码 │
│ └── 语句（包含表达式） │
└─────────────────────────────────────────┘最后
C# 程序结构看起来层级多，但理解了就那几样东西：入口点、命名空间、类型、成员、语句。新手最容易困惑的是"顶级语句为什么没有 Main"------答案是编译器帮你生成了，你看到的顶层代码最终会被包进一个隐式的 <Main>$ 方法里。语法糖是为了让你少写模板代码，底层模型并没有变。