Razor 內幕：三階段解析器架構與遞迴解析流程

前言

Razor 解析器並非單一正則引擎，而是由三大組件協作：標記解析器、程式碼解析器 (C#/VB)、中央控制器。三者透過狀態機與遞迴呼叫完成解析。

三大組件

• HtmlMarkupParser：理解 HTML 語法，處理標記文件、標記區塊。
• CSharpCodeParser / VBCodeParser：理解程式碼語法，處理程式碼區塊。
• ParserController：中央控制器，協調狀態切換與遞迴。

三種解析狀態

1. 解析標記文件
2. 解析標記區塊
3. 解析程式碼區塊

解析流程範例

<ul>
@foreach(var p in Model.Products) {
<li>@p.Name ($@p.Price)</li>
}
</ul>

1. 起始狀態：HtmlMarkupParser.ParseDocument() 掃描至 @。
2. 切換至 CSharpCodeParser.ParseBlock() 解析 foreach 區塊。
3. 遇到 <li>，程式碼解析器識別非 C# 語法，回呼 HtmlMarkupParser.ParseBlock() 解析標記區塊。
4. 標記區塊中再遇 @p.Name，再次切換至程式碼解析器解析隱含運算式。
5. 形成呼叫堆疊：HtmlMarkupParser.ParseDocument → CSharpCodeParser.ParseBlock → HtmlMarkupParser.ParseBlock → CSharpCodeParser.ParseBlock。
6. </li> 結束標記區塊，返回 foreach 區塊，最終 } 結束程式碼區塊，回到文件頂層。

ASPX vs Razor 解析差異

• ASPX：標記與程式碼為兩條平行流，透過 <% %> 切換。
• Razor：樹狀巢狀結構，標記中嵌程式碼，程式碼中再嵌標記，透過語法理解自動推斷邊界。

總結

Razor 解析器的多組件協作與遞迴下降架構，賦予其強大的語法推斷能力，實現「少儀式、高可讀」的模板體驗。