Razor不是独立语言，而是ASP.NET中用@符号在HTML中嵌入C#代码的标记语法层；@{ }是纯C#代码块需分号，@model等为Razor指令无需分号；变量作用域遵循C#块级规则，@inject等指令必须置于文件顶部而非@{ }内。
直接说结论：Razor 不是独立语言，它是 ASP.NET 中把 C# 逻辑“缝进” HTML 的标记语法层，核心就一条——用 @ 切换上下文。写错的地方，90% 都卡在“什么时候该加分号”“@ 后面能不能跟空格”“变量作用域怎么算”这三处。
为什么 @{ } 里要加分号，但 @model 或 @DateTime.Now 不用？
因为语义不同：@{ } 是纯 C# 代码块，编译器把它当 .cs 文件里的一段来看，所以必须遵守 C# 语法规则（分号结尾、大括号配对）；而 @model、@DateTime.Now 这类是 Razor 指令或内联表达式，属于“模板指令语法”，由 Razor 解析器单独处理，不走 C# 编译流程。
常见错误现象：
-
@{ var x = 1 }—— 缺少分号，报错CS1002: ; expected -
@ model MyViewModel——@后多了空格，被解析成 HTML 文本@ model，而不是指令 -
@if (x > 0) { <p>ok</p> }—— 大括号里混了 HTML，必须用@开头的完整语句结构，不能直接写裸 HTML
@ 后面跟变量、函数、条件表达式时，括号到底要不要加？
只有一种情况强制加括号：@ 后面不是单一标识符（variable / property / method call），而是含运算符或三元操作的复合表达式。否则会解析失败或语义错乱。
使用场景和写法对比：
- 安全写法（总是有效）：
@(user.FirstName + " " + user.LastName)、@(DateTime.Now.Year > 2025 ? "new" : "old") - 能省括号的情况：
@user.Name、@DateTime.Now.ToString("t")、@GetTitle() - 容易踩坑：
@user.Name.Length看似没问题，但如果user为 null，运行时报NullReferenceException，而加了括号也救不了——得靠空合并：@(user?.Name?.Length ?? 0)
Razor 变量的作用域到底怎么算？声明位置决定一切
Razor 没有“全局变量”概念，所有变量都遵循 C# 块级作用域规则，但新手常误以为 @{ } 块外也能访问里面定义的变量——其实不能。
关键判断点：
-
@{ var x = 1; }定义在页面顶层：整个 .cshtml 文件内都可读（包括后续@if、@foreach块） -
@if (true) { var y = 2; }：y 仅在 if 大括号内有效，外面访问报CS0103: The name 'y' does not exist -
@foreach (var item in list) { var z = item.Id; }：z 每次循环都是新变量，循环外不可见 - 跨
@{ }块复用变量？可以，但必须在同一个块里声明，或提升到外层块——别指望两个分离的@{ }共享变量
@inject、@using、@model 这些指令为什么不能写在 @{ } 里？
因为它们不是 C# 代码，是 Razor 编译器预处理指令，必须出现在文件顶部（或至少在任何 HTML/表达式之前），且不能嵌套在代码块中。写进去不会报错，但会被忽略或触发不可预测行为。
典型错误：
-
@{ @inject IOptions<appsettings> settings; }</appsettings>——@inject在@{ }内，服务根本没注入，运行时报NullReferenceException -
@{ @using System.Linq; }—— using 不生效，后面用.Where()会提示“未找到定义” -
@{ @model MyViewModel }—— 模型绑定失效，@Model为 null，视图编译可能直接失败
真正该放的位置：文件最开头，HTML 标签之前，且每条指令只出现一次（@model 尤其不能重复）。
最常被忽略的一点：Razor 编译是两阶段的——先由 Razor 解析器提取指令和表达式，再把生成的 C# 类交给 Roslyn 编译。这意味着语法错误可能报在“生成的 .g.cs 文件”里，而不是你写的 .cshtml 行号上。查错时别只盯着红波浪线，要看输出窗口里真正的编译错误路径和行号。
