Microsoft 的 Visual Studio Code 1.146 更新頁面記錄了截至 2026 年 11 月 13 日期間的一項文件工具變更：編輯器從 Mermaid 11 移至 Mermaid 12。這項變更範圍有限，但可能影響將轉譯後的 Markdown 圖表視為經審核工程產物的團隊。
對 CTO 與工程領導者而言，訊號很明確：內建圖表程式庫的升級應納入文件測試計畫。這不僅是版本標籤變更，而是轉譯相依性的變更，可能影響預覽一致性、核准流程與發佈工作流程。
1. Mermaid 12 取代 Mermaid 11
這是什麼
Microsoft 的 Visual Studio Code 更新頁面直接呈現了此轉換：
| 之前 | 之後 |
|---|---|
Mermaid 11 | Mermaid 12 |
根據 Microsoft 的版本記錄，此變更是 Visual Studio Code 1.146 的一部分，其穩定版本於 2026 年 11 月 11 日發布。Mermaid 提供通常嵌入 Markdown 的文字定義圖表，而 Visual Studio Code 將 Mermaid 轉譯整合至其 Markdown 相關工具中。
因此，此更新改變了編輯器整合式圖表工作流程所使用的主要版本。升級編輯器的開發人員，可在該內建體驗中取得新的主要版本，而無須另外安裝 Mermaid。
Mermaid 的 12.3.0 版本資訊說明了若干新增功能，包括 BPMN 元素形狀、開放箭頭與空心圓邊緣標記，以及可選用的流程圖邊線動畫。這些上游功能為 Mermaid 12 系列提供了背景脈絡，但在 Microsoft 確認內建的次要版本之前，團隊不應將每項 12.3.0 功能都視為已在 Visual Studio Code 中獲得確認。
為何重要
即使來源文字保持不變，主要轉譯程式庫的變更仍可能改變既有圖表的呈現方式。版面配置、間距、連接線、標籤與樣式，都是架構圖與營運文件的審查面向。
這不是阻擋更新的理由，而是測試重要產物的理由。
為何這很重要： 團隊通常在製作圖表時使用 Visual Studio Code 預覽，接著透過獨立的文件產生器或持續整合管線轉譯相同檔案。若這些環境使用不同的 Mermaid 主要版本，編輯器預覽可能不再與已發佈結果一致。
對受監管產業而言，文件一致性是一項治理要求。在一個轉譯環境中獲得核准的圖表，不應在另一個環境中悄悄產生實質不同的輸出。
擴充功能作者也需要區分 Visual Studio Code 的整合式 Mermaid 支援，與其自有擴充功能所封裝的 Mermaid 相依性。更新編輯器並不代表每個支援 Mermaid 的擴充功能或外部轉譯器都已移至相同版本。
或許最具影響力的問題是版本對齊。若編輯器預覽、提取請求檢查與發佈系統透過不同 Mermaid 版本轉譯同一張圖表，團隊可能會將審查時間耗費在調查輸出差異，而非內容變更。
以 Agent 為先的開發可能是現代開發工具更廣泛的趨勢，但文件相依性仍需要傳統的版本發布紀律。轉譯一致性仍是一項工程控制措施。
重點摘要
Visual Studio Code 1.146 將其整合式圖表工具從 Mermaid 11 推進至 Mermaid 12。Microsoft 確認了主要版本的轉換，但更新項目未指出確切的 Mermaid 12 次要或修補版本。
這對企業團隊的意義：
建立基準。 在廣泛部署 Visual Studio Code
1.146前，擷取具代表性、業務關鍵 Mermaid 圖表的目前輸出結果。比較轉譯輸出。 更新後審查版面配置、標籤、連接線、色彩與可讀性，而不要只依賴成功解析的結果。
檢查發佈路徑。 確認文件產生器與持續整合工作是否使用 Mermaid 11、Mermaid 12 或其他轉譯器。
區分已確認支援與上游可用性。 不要僅根據 Microsoft 對
Mermaid 12的確認，就承諾支援12.3.0特定功能。記錄已接受的差異。 若新轉譯器改變了已核准的圖表，請在更新後的輸出進入正式文件前記錄該決策。
祝您程式開發愉快！