法高亮引擎全解析：基于 Pygments 的 Go 實(shí)現(xiàn)、XML 詞法定義與實(shí)戰(zhàn)用法)
Chroma v2 語(yǔ)法高亮引擎全解析基于 Pygments 的 Go 實(shí)現(xiàn)、XML 詞法定義與實(shí)戰(zhàn)用法【免費(fèi)下載鏈接】sliverAdversary Emulation Framework項(xiàng)目地址: https://gitcode.com/gh_mirrors/sl/sliverChroma 是使用純 Go 編寫(xiě)的通用語(yǔ)法高亮庫(kù)、命令行工具與 Web Playground其設(shè)計(jì)大量繼承自 Python 生態(tài)中的 Pygments并內(nèi)置了 Pygments 詞法器Lexer與主題Style的導(dǎo)入機(jī)制。本指南圍繞 Chroma v2 的架構(gòu)骨架Lexer / Formatter / Style 三要素、工程結(jié)構(gòu)與構(gòu)建工具鏈、Web Playground 的兩種運(yùn)行模式以及 CLI 與庫(kù)的實(shí)戰(zhàn)用法展開(kāi)幫助讀者快速在 Go 項(xiàng)目中集成語(yǔ)法高亮并理解其底層工作方式。Chroma 的定位與三大核心概念Chroma 把源碼或其他結(jié)構(gòu)化文本轉(zhuǎn)換成帶語(yǔ)法高亮的 HTML、ANSI 彩色終端文本等輸出。與 Pygments 一脈相承Chroma 也以三個(gè)相互協(xié)作的概念為核心Lexer詞法器把源碼文本轉(zhuǎn)換成一個(gè) Token 流Style主題規(guī)定每種 Token 類(lèi)型如何映射到顏色Formatter格式化器把 Token 流與 Style 組合成格式化后的輸出。這三個(gè)概念在倉(cāng)庫(kù)中分別有獨(dú)立包并且每個(gè)包內(nèi)都有一個(gè)全局Registry變量保存所有已注冊(cè)的實(shí)現(xiàn)同時(shí)提供按名稱(chēng)查找詞法器、按文件名匹配等輔助函數(shù)見(jiàn) vendor/github.com/alecthomas/chroma/v2/README.md。在無(wú)法確定詞法器、格式化器或主題時(shí)這些查找函數(shù)會(huì)返回nil此時(shí)可以回退到各包提供的Fallback值。工程結(jié)構(gòu)與構(gòu)建工具鏈根據(jù) AGENTS.md項(xiàng)目本身用 Go 編寫(xiě)并依賴(lài)兩套工具鏈Hermit負(fù)責(zé)管理工具版本Just提供輔助命令等價(jià)于 Makefile 的角色輔助工具代碼集中在./_tools目錄。Chroma 對(duì)“配置”的獨(dú)特處理在于語(yǔ)言定義與主題都采用 XML 文件描述而不是硬編碼在 Go 源碼里語(yǔ)言定義Lexer位于./lexers/embedded/*.xml倉(cāng)庫(kù)中已有數(shù)百個(gè) XML 文件例如 kotlin.xml、c.xml 等主題Style位于./styles/*.xml倉(cāng)庫(kù)內(nèi)置了 monokai、dracula、github、solarized-dark、tokyonight、catppuccin 等數(shù)十個(gè)主題見(jiàn) styles 目錄。這也是為什么 Chroma 能自動(dòng)轉(zhuǎn)換 Pygments 的詞法器與主題二者使用幾乎相同的描述語(yǔ)法轉(zhuǎn)換腳本見(jiàn)_tools/pygments2chroma_xml.py與_tools/style.py。項(xiàng)目提供兩個(gè)可直接運(yùn)行的程序chroma命令行高亮工具chromadWeb Playground 服務(wù)可用chromad --csrf-keymoo啟動(dòng)。它是一個(gè)阻塞進(jìn)程通常應(yīng)在后臺(tái)運(yùn)行且不支持熱重載修改代碼后需要手動(dòng)重啟。Playground 有兩種運(yùn)行模式本地開(kāi)發(fā)模式直接使用服務(wù)端自身完成渲染生產(chǎn)模式運(yùn)行just chromad將./cmd/libchromawasm編譯成 WASM 模塊再打包進(jìn)chromad二進(jìn)制在瀏覽器端完成渲染。生產(chǎn)模式的完整構(gòu)建鏈可以從 Justfile 還原先用 TinyGo或GOOSjs GOARCHwasm go build兜底把 cmd/libchromawasm/main.go 編譯為chroma.wasm再用 esbuild 壓縮前端 JS/CSS最后CGOENABLED0 go build出build/chromad?？焖偕鲜忠恍写a完成高亮庫(kù)的 v2 版本使用導(dǎo)入路徑import github.com/alecthomas/chroma/v2如果不關(guān)心詞法、主題的選擇細(xì)節(jié)可以用quick包的一行調(diào)用完成高亮輸出見(jiàn) quick/quick.goerr : quick.Highlight(os.Stdout, someSourceCode, go, html, monokai)從源碼看quick.Highlight內(nèi)部會(huì)自動(dòng)執(zhí)行完整的“兜底鏈”先lexers.Get(lexer)按名字取詞法器失敗則lexers.Analyse(source)按內(nèi)容分析再失敗則使用lexers.Fallback隨后對(duì)詞法器執(zhí)行chroma.Coalesce格式化器與主題同樣依次回退到Fallback最后調(diào)用lexer.Tokenise與formatter.Format。語(yǔ)言識(shí)別三種確定 Lexer 的方式在高亮之前必須先確定源碼屬于哪種語(yǔ)言Chroma 提供三種方式見(jiàn) README.md按文件名匹配lexer : lexers.Match(foo.go)按 Chroma 語(yǔ)法 ID 顯式指定完整列表可通過(guò)lexers.Names()獲取lexer : lexers.Get(go)按內(nèi)容分析lexer : lexers.Analyse(package main\n\nfunc main()\n{\n}\n)以上三種方式在無(wú)法識(shí)別時(shí)都會(huì)返回nil需要顯式兜底if lexer nil { lexer lexers.Fallback }注意部分詞法器可能產(chǎn)生非常“啰嗦”的 Token 輸出即相鄰 token 類(lèi)型相同卻反復(fù)出現(xiàn)。此時(shí)可以用合并詞法器Coalescing Lexer把連續(xù)相同類(lèi)型的 Token 合并成單個(gè) Token顯著降低下游處理負(fù)擔(dān)lexer chroma.Coalesce(lexer)Formatter 與 Style輸出的最后兩環(huán)確定語(yǔ)言后需要選定格式化器與主題style : styles.Get(swapoff) if style nil { style styles.Fallback } formatter : formatters.Get(html) if formatter nil { formatter formatters.Fallback }然后取得 Token 迭代器contents, err : ioutil.ReadAll(r) iterator, err : lexer.Tokenise(nil, string(contents))最后把 Token 迭代器交給格式化器輸出w是任意io.Writererr : formatter.Format(w, style, iterator)HTML Formatter 的構(gòu)造選項(xiàng)默認(rèn)注冊(cè)的html格式化器生成帶內(nèi)嵌 CSS 的獨(dú)立 HTML。需要更細(xì)控制時(shí)應(yīng)使用formatters/html包其構(gòu)造選項(xiàng)包括Standalone()生成內(nèi)嵌 CSS 的獨(dú)立 HTMLWithClasses()使用 CSS class 而非內(nèi)聯(lián)樣式屬性ClassPrefix(prefix)為每個(gè)生成的 CSS class 添加前綴TabWidth(width)設(shè)置渲染 Tab 的字符寬度WithLineNumbers()渲染行號(hào)可用LineNumbers主題類(lèi)型設(shè)置樣式WithLinkableLineNumbers()讓行號(hào)可鏈接并指向自身HighlightLines(ranges)高亮指定行區(qū)間用LineHighlight類(lèi)型設(shè)置樣式LineNumbersInTable()使用 table 而非 span 來(lái)排版行號(hào)與代碼。如果啟用了WithClasses()可以從格式化器直接取得對(duì)應(yīng)的 CSSformatter : html.New(html.WithClasses(true)) err : formatter.WriteCSS(w, style)終端格式化器除 HTML 外Chroma 還支持終端輸出8 色、256 色與真彩色true-colour三種模式對(duì)應(yīng) formatters/tty_indexed.go 與 formatters/tty_truecolour.go。此外還內(nèi)置noop格式化器僅輸出 Token 文本與tokens格式化器輸出原始 Token 流后者常用于調(diào)試詞法器JSON 格式化器見(jiàn) formatters/json.go。主題體系XML 定義、Background 與層級(jí)繼承Chroma 的主題用 XML 定義條目語(yǔ)法與 Pygments 相同entry type... style.../。主題名不區(qū)分大小寫(xiě)monokai與Monokai等價(jià)。使用 Chroma 主題時(shí)需要理解兩條關(guān)鍵規(guī)則見(jiàn) README.mdBackgroundToken 類(lèi)型提供默認(rèn)樣式它通過(guò)定義前景色與背景色為所有未在主題中顯式定義的 Token 提供默認(rèn)配色。例如下面這行讓所有未定義的 Token 默認(rèn)前景色為#f8f8f2、高亮代碼塊背景為#000000entry typeBackground style#f8f8f2 bg:#000000/Token 類(lèi)型具有層級(jí)繼承例如未定義CommentSpecial時(shí)Chroma 會(huì)使用Comment的樣式。因此當(dāng)多個(gè)注釋類(lèi) Token 使用相同顏色時(shí)只需定義Comment再單獨(dú)覆蓋顏色不同的那一個(gè)。這一機(jī)制大幅壓縮了主題文件體積也讓自定義主題非常輕量。CLI 實(shí)戰(zhàn)chroma 與 less 集成chroma命令行工具可以作為less(1)的預(yù)處理器為終端輸出著色。核心技巧是使用--fail標(biāo)志當(dāng) Chroma 無(wú)法為給定文件解析出合適的詞法器時(shí)--fail會(huì)抑制輸出并返回退出碼 1便于回退到其他預(yù)處理器。經(jīng)典用法export LESSOPEN| p() { chroma --fail $1 || cat $1; }; p %s把cat替換成你喜歡的兜底預(yù)處理器即可。當(dāng)chroma以.lessfilter名稱(chēng)被調(diào)用時(shí)--fail會(huì)被自動(dòng)開(kāi)啟從而無(wú)縫對(duì)接 Debian 系發(fā)行版自帶的lesspipe——此時(shí)只需把chroma可執(zhí)行文件符號(hào)鏈接到~/.lessfilter。獲取當(dāng)前支持語(yǔ)言的權(quán)威列表使用chroma --list測(cè)試與詞法器開(kāi)發(fā)Chroma 的詞法器默認(rèn)都定義為 XML除非需要自定義代碼見(jiàn) lexers/README.md。測(cè)試約定為將已知輸入testdata/name.actual喂給name詞法器校驗(yàn)輸出與name.expected一致同一個(gè)詞法器也可以放在testdata/name/目錄下對(duì)應(yīng)多組輸入。運(yùn)行測(cè)試go test ./lexers新增或修改詞法器后需要重新生成*.expected文件只需設(shè)置環(huán)境變量RECORDtrueRECORDtrue go test ./lexersWindows 用戶(hù)在 cmd 與 PowerShell 下需分兩步先set RECORDtrue或$env:RECORD true再運(yùn)行g(shù)o test ./lexers。詞法器的編寫(xiě)思路可以參考 Pygments 的詞法器開(kāi)發(fā)文檔絕大多數(shù)概念直接適用倉(cāng)庫(kù)中的現(xiàn)有詞法器是最佳范例。在 Sliver 項(xiàng)目中的實(shí)際應(yīng)用本倉(cāng)庫(kù)Sliver在客戶(hù)端代碼中直接消費(fèi)了 Chroma v2 的能力是理解其真實(shí)用法的絕佳參考client/command/edit/editor.go 導(dǎo)入github.com/alecthomas/chroma/v2、formatters與styles在編輯器模型中持有chroma.Lexer、chroma.Formatter與*chroma.Style三類(lèi)對(duì)象用于對(duì)編輯中的源碼做語(yǔ)法高亮渲染client/command/filesystem/cat.go 導(dǎo)入chroma的 formatters、lexers、styles 三個(gè)子包用于在終端中高亮顯示遠(yuǎn)程文件內(nèi)容。這說(shuō)明 Chroma 的典型接入模式正是按文件/內(nèi)容解析 Lexer → 選取 Formatter 與 Style → Tokenise → Format 輸出與上文介紹的庫(kù)級(jí)用法完全一致。與 Pygments 的差異與邊界Chroma 從 Pygments 繼承了絕大多數(shù)概念但并非完整移植。需要留意以下幾點(diǎn)見(jiàn) README.md部分 Pygments 詞法器未移植尤其是一些復(fù)雜語(yǔ)言依賴(lài)自定義代碼處理特殊情況例如 Raku 在正則表達(dá)式中嵌套代碼的能力需要額外投入才能轉(zhuǎn)換一些更冷門(mén)的 Pygments 特性被刻意省略以保持實(shí)現(xiàn)簡(jiǎn)潔雖然 Chroma 的 API 支持基于內(nèi)容檢測(cè)語(yǔ)言但支持該能力的詞法器數(shù)量有限。因此當(dāng)接入 Chroma 時(shí)建議優(yōu)先通過(guò)chroma --list確認(rèn)目標(biāo)語(yǔ)言是否可用并善用lexers.Fallback/styles.Fallback/formatters.Fallback保證在未知輸入下仍能優(yōu)雅降級(jí)。【免費(fèi)下載鏈接】sliverAdversary Emulation Framework項(xiàng)目地址: https://gitcode.com/gh_mirrors/sl/sliver創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Chroma v2 語(yǔ)法高亮引擎全解析：基于 Pygments 的 Go 實(shí)現(xiàn)、XML 詞法定義與實(shí)戰(zhàn)用法
Chroma v2 語(yǔ)法高亮引擎全解析基于 Pygments 的 Go 實(shí)現(xiàn)、XML 詞法定義與實(shí)戰(zhàn)用法【免費(fèi)下載鏈接】sliverAdversary Emulation Framework項(xiàng)目地址: https://gitcode.com/gh_mirrors/sl/sliverChroma 是使用純 Go 編寫(xiě)的通用語(yǔ)法高亮庫(kù)、命令行工具與 Web Playground其設(shè)計(jì)大量繼承自 Python 生態(tài)中的 Pygments并內(nèi)置了 Pygments 詞法器Lexer與主題Style的導(dǎo)入機(jī)制。本指南圍繞 Chroma v2 的架構(gòu)骨架Lexer / Formatter / Style 三要素、工程結(jié)構(gòu)與構(gòu)建工具鏈、Web Playground 的兩種運(yùn)行模式以及 CLI 與庫(kù)的實(shí)戰(zhàn)用法展開(kāi)幫助讀者快速在 Go 項(xiàng)目中集成語(yǔ)法高亮并理解其底層工作方式。Chroma 的定位與三大核心概念Chroma 把源碼或其他結(jié)構(gòu)化文本轉(zhuǎn)換成帶語(yǔ)法高亮的 HTML、ANSI 彩色終端文本等輸出。與 Pygments 一脈相承Chroma 也以三個(gè)相互協(xié)作的概念為核心Lexer詞法器把源碼文本轉(zhuǎn)換成一個(gè) Token 流Style主題規(guī)定每種 Token 類(lèi)型如何映射到顏色Formatter格式化器把 Token 流與 Style 組合成格式化后的輸出。這三個(gè)概念在倉(cāng)庫(kù)中分別有獨(dú)立包并且每個(gè)包內(nèi)都有一個(gè)全局Registry變量保存所有已注冊(cè)的實(shí)現(xiàn)同時(shí)提供按名稱(chēng)查找詞法器、按文件名匹配等輔助函數(shù)見(jiàn) vendor/github.com/alecthomas/chroma/v2/README.md。在無(wú)法確定詞法器、格式化器或主題時(shí)這些查找函數(shù)會(huì)返回nil此時(shí)可以回退到各包提供的Fallback值。工程結(jié)構(gòu)與構(gòu)建工具鏈根據(jù) AGENTS.md項(xiàng)目本身用 Go 編寫(xiě)并依賴(lài)兩套工具鏈Hermit負(fù)責(zé)管理工具版本Just提供輔助命令等價(jià)于 Makefile 的角色輔助工具代碼集中在./_tools目錄。Chroma 對(duì)“配置”的獨(dú)特處理在于語(yǔ)言定義與主題都采用 XML 文件描述而不是硬編碼在 Go 源碼里語(yǔ)言定義Lexer位于./lexers/embedded/*.xml倉(cāng)庫(kù)中已有數(shù)百個(gè) XML 文件例如 kotlin.xml、c.xml 等主題Style位于./styles/*.xml倉(cāng)庫(kù)內(nèi)置了 monokai、dracula、github、solarized-dark、tokyonight、catppuccin 等數(shù)十個(gè)主題見(jiàn) styles 目錄。這也是為什么 Chroma 能自動(dòng)轉(zhuǎn)換 Pygments 的詞法器與主題二者使用幾乎相同的描述語(yǔ)法轉(zhuǎn)換腳本見(jiàn)_tools/pygments2chroma_xml.py與_tools/style.py。項(xiàng)目提供兩個(gè)可直接運(yùn)行的程序chroma命令行高亮工具chromadWeb Playground 服務(wù)可用chromad --csrf-keymoo啟動(dòng)。它是一個(gè)阻塞進(jìn)程通常應(yīng)在后臺(tái)運(yùn)行且不支持熱重載修改代碼后需要手動(dòng)重啟。Playground 有兩種運(yùn)行模式本地開(kāi)發(fā)模式直接使用服務(wù)端自身完成渲染生產(chǎn)模式運(yùn)行just chromad將./cmd/libchromawasm編譯成 WASM 模塊再打包進(jìn)chromad二進(jìn)制在瀏覽器端完成渲染。生產(chǎn)模式的完整構(gòu)建鏈可以從 Justfile 還原先用 TinyGo或GOOSjs GOARCHwasm go build兜底把 cmd/libchromawasm/main.go 編譯為chroma.wasm再用 esbuild 壓縮前端 JS/CSS最后CGOENABLED0 go build出build/chromad?？焖偕鲜忠恍写a完成高亮庫(kù)的 v2 版本使用導(dǎo)入路徑import github.com/alecthomas/chroma/v2如果不關(guān)心詞法、主題的選擇細(xì)節(jié)可以用quick包的一行調(diào)用完成高亮輸出見(jiàn) quick/quick.goerr : quick.Highlight(os.Stdout, someSourceCode, go, html, monokai)從源碼看quick.Highlight內(nèi)部會(huì)自動(dòng)執(zhí)行完整的“兜底鏈”先lexers.Get(lexer)按名字取詞法器失敗則lexers.Analyse(source)按內(nèi)容分析再失敗則使用lexers.Fallback隨后對(duì)詞法器執(zhí)行chroma.Coalesce格式化器與主題同樣依次回退到Fallback最后調(diào)用lexer.Tokenise與formatter.Format。語(yǔ)言識(shí)別三種確定 Lexer 的方式在高亮之前必須先確定源碼屬于哪種語(yǔ)言Chroma 提供三種方式見(jiàn) README.md按文件名匹配lexer : lexers.Match(foo.go)按 Chroma 語(yǔ)法 ID 顯式指定完整列表可通過(guò)lexers.Names()獲取lexer : lexers.Get(go)按內(nèi)容分析lexer : lexers.Analyse(package main\n\nfunc main()\n{\n}\n)以上三種方式在無(wú)法識(shí)別時(shí)都會(huì)返回nil需要顯式兜底if lexer nil { lexer lexers.Fallback }注意部分詞法器可能產(chǎn)生非常“啰嗦”的 Token 輸出即相鄰 token 類(lèi)型相同卻反復(fù)出現(xiàn)。此時(shí)可以用合并詞法器Coalescing Lexer把連續(xù)相同類(lèi)型的 Token 合并成單個(gè) Token顯著降低下游處理負(fù)擔(dān)lexer chroma.Coalesce(lexer)Formatter 與 Style輸出的最后兩環(huán)確定語(yǔ)言后需要選定格式化器與主題style : styles.Get(swapoff) if style nil { style styles.Fallback } formatter : formatters.Get(html) if formatter nil { formatter formatters.Fallback }然后取得 Token 迭代器contents, err : ioutil.ReadAll(r) iterator, err : lexer.Tokenise(nil, string(contents))最后把 Token 迭代器交給格式化器輸出w是任意io.Writererr : formatter.Format(w, style, iterator)HTML Formatter 的構(gòu)造選項(xiàng)默認(rèn)注冊(cè)的html格式化器生成帶內(nèi)嵌 CSS 的獨(dú)立 HTML。需要更細(xì)控制時(shí)應(yīng)使用formatters/html包其構(gòu)造選項(xiàng)包括Standalone()生成內(nèi)嵌 CSS 的獨(dú)立 HTMLWithClasses()使用 CSS class 而非內(nèi)聯(lián)樣式屬性ClassPrefix(prefix)為每個(gè)生成的 CSS class 添加前綴TabWidth(width)設(shè)置渲染 Tab 的字符寬度WithLineNumbers()渲染行號(hào)可用LineNumbers主題類(lèi)型設(shè)置樣式WithLinkableLineNumbers()讓行號(hào)可鏈接并指向自身HighlightLines(ranges)高亮指定行區(qū)間用LineHighlight類(lèi)型設(shè)置樣式LineNumbersInTable()使用 table 而非 span 來(lái)排版行號(hào)與代碼。如果啟用了WithClasses()可以從格式化器直接取得對(duì)應(yīng)的 CSSformatter : html.New(html.WithClasses(true)) err : formatter.WriteCSS(w, style)終端格式化器除 HTML 外Chroma 還支持終端輸出8 色、256 色與真彩色true-colour三種模式對(duì)應(yīng) formatters/tty_indexed.go 與 formatters/tty_truecolour.go。此外還內(nèi)置noop格式化器僅輸出 Token 文本與tokens格式化器輸出原始 Token 流后者常用于調(diào)試詞法器JSON 格式化器見(jiàn) formatters/json.go。主題體系XML 定義、Background 與層級(jí)繼承Chroma 的主題用 XML 定義條目語(yǔ)法與 Pygments 相同entry type... style.../。主題名不區(qū)分大小寫(xiě)monokai與Monokai等價(jià)。使用 Chroma 主題時(shí)需要理解兩條關(guān)鍵規(guī)則見(jiàn) README.mdBackgroundToken 類(lèi)型提供默認(rèn)樣式它通過(guò)定義前景色與背景色為所有未在主題中顯式定義的 Token 提供默認(rèn)配色。例如下面這行讓所有未定義的 Token 默認(rèn)前景色為#f8f8f2、高亮代碼塊背景為#000000entry typeBackground style#f8f8f2 bg:#000000/Token 類(lèi)型具有層級(jí)繼承例如未定義CommentSpecial時(shí)Chroma 會(huì)使用Comment的樣式。因此當(dāng)多個(gè)注釋類(lèi) Token 使用相同顏色時(shí)只需定義Comment再單獨(dú)覆蓋顏色不同的那一個(gè)。這一機(jī)制大幅壓縮了主題文件體積也讓自定義主題非常輕量。CLI 實(shí)戰(zhàn)chroma 與 less 集成chroma命令行工具可以作為less(1)的預(yù)處理器為終端輸出著色。核心技巧是使用--fail標(biāo)志當(dāng) Chroma 無(wú)法為給定文件解析出合適的詞法器時(shí)--fail會(huì)抑制輸出并返回退出碼 1便于回退到其他預(yù)處理器。經(jīng)典用法export LESSOPEN| p() { chroma --fail $1 || cat $1; }; p %s把cat替換成你喜歡的兜底預(yù)處理器即可。當(dāng)chroma以.lessfilter名稱(chēng)被調(diào)用時(shí)--fail會(huì)被自動(dòng)開(kāi)啟從而無(wú)縫對(duì)接 Debian 系發(fā)行版自帶的lesspipe——此時(shí)只需把chroma可執(zhí)行文件符號(hào)鏈接到~/.lessfilter。獲取當(dāng)前支持語(yǔ)言的權(quán)威列表使用chroma --list測(cè)試與詞法器開(kāi)發(fā)Chroma 的詞法器默認(rèn)都定義為 XML除非需要自定義代碼見(jiàn) lexers/README.md。測(cè)試約定為將已知輸入testdata/name.actual喂給name詞法器校驗(yàn)輸出與name.expected一致同一個(gè)詞法器也可以放在testdata/name/目錄下對(duì)應(yīng)多組輸入。運(yùn)行測(cè)試go test ./lexers新增或修改詞法器后需要重新生成*.expected文件只需設(shè)置環(huán)境變量RECORDtrueRECORDtrue go test ./lexersWindows 用戶(hù)在 cmd 與 PowerShell 下需分兩步先set RECORDtrue或$env:RECORD true再運(yùn)行g(shù)o test ./lexers。詞法器的編寫(xiě)思路可以參考 Pygments 的詞法器開(kāi)發(fā)文檔絕大多數(shù)概念直接適用倉(cāng)庫(kù)中的現(xiàn)有詞法器是最佳范例。在 Sliver 項(xiàng)目中的實(shí)際應(yīng)用本倉(cāng)庫(kù)Sliver在客戶(hù)端代碼中直接消費(fèi)了 Chroma v2 的能力是理解其真實(shí)用法的絕佳參考client/command/edit/editor.go 導(dǎo)入github.com/alecthomas/chroma/v2、formatters與styles在編輯器模型中持有chroma.Lexer、chroma.Formatter與*chroma.Style三類(lèi)對(duì)象用于對(duì)編輯中的源碼做語(yǔ)法高亮渲染client/command/filesystem/cat.go 導(dǎo)入chroma的 formatters、lexers、styles 三個(gè)子包用于在終端中高亮顯示遠(yuǎn)程文件內(nèi)容。這說(shuō)明 Chroma 的典型接入模式正是按文件/內(nèi)容解析 Lexer → 選取 Formatter 與 Style → Tokenise → Format 輸出與上文介紹的庫(kù)級(jí)用法完全一致。與 Pygments 的差異與邊界Chroma 從 Pygments 繼承了絕大多數(shù)概念但并非完整移植。需要留意以下幾點(diǎn)見(jiàn) README.md部分 Pygments 詞法器未移植尤其是一些復(fù)雜語(yǔ)言依賴(lài)自定義代碼處理特殊情況例如 Raku 在正則表達(dá)式中嵌套代碼的能力需要額外投入才能轉(zhuǎn)換一些更冷門(mén)的 Pygments 特性被刻意省略以保持實(shí)現(xiàn)簡(jiǎn)潔雖然 Chroma 的 API 支持基于內(nèi)容檢測(cè)語(yǔ)言但支持該能力的詞法器數(shù)量有限。因此當(dāng)接入 Chroma 時(shí)建議優(yōu)先通過(guò)chroma --list確認(rèn)目標(biāo)語(yǔ)言是否可用并善用lexers.Fallback/styles.Fallback/formatters.Fallback保證在未知輸入下仍能優(yōu)雅降級(jí)。【免費(fèi)下載鏈接】sliverAdversary Emulation Framework項(xiàng)目地址: https://gitcode.com/gh_mirrors/sl/sliver創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考