完美代码配色：ad编辑器tree-sitter语法高亮配置与正则高亮备选方案

完美代码配色ad编辑器tree-sitter语法高亮配置与正则高亮备选方案【免费下载链接】adan adaptable text editor项目地址: https://gitcode.com/gh_mirrors/ad5/ad想要让代码阅读更舒适语法高亮和代码配色是第一道门槛。ad编辑器an adaptable text editor是一款融合了 Vim 模式编辑、Kakoune 选区操作与 Plan9 Acme 扩展哲学的开源终端文本编辑器它内置了一套完整的tree-sitter 语法高亮配置体系同时也为没有语法树支持的格式准备了基于正则的高亮备选方案。本文将手把手带你完成 ad编辑器 的语法高亮配置与代码配色定制从目录结构、配置文件到配色主题一次讲透。1. ad编辑器语法高亮机制tree-sitter与正则双通道理解 ad编辑器 的高亮原理是完成代码配色配置的前提。在源码 src/syntax/mod.rs 中SyntaxState会根据文件类型动态选择两条高亮通道tree-sitter 通道主流语言走语法树解析由ts::TsState实现精确、增量更新性能极佳正则通道当某个文件类型配置了re_syntax时退化到基于行的正则匹配由re::ReState实现简单快速但精度有限。判断逻辑很简单文件类型配置里若没有re_syntax字段就启用 tree-sitter有则用正则高亮。这意味着你可以为冷门格式单独指定正则高亮而不影响主流语言的精确解析。2. 快速上手两步完成tree-sitter语法高亮配置第一步克隆并初始化配置文件ad编辑器 的默认配置目录需要手动初始化最快的配置方法如下git clone https://gitcode.com/gh_mirrors/ad5/ad cd ad cargo install --path . cargo xtask setup-dotfilessetup-dotfiles任务实现见 xtask/src/setup.rs会把内置配置复制到~/.ad/下包括config.toml、颜色主题与默认的 tree-sitter 查询文件。第二步确认tree-sitter目录结构在~/.ad/config.toml中与高亮相关的关键配置是[tree_sitter]段[tree_sitter] # 存放编译好的 *.so 语法解析器 parser_dir ~/.ad/tree-sitter/parsers # 存放各语言的语法高亮查询文件 syntax_query_dir ~/.ad/tree-sitter/queriesad编辑器 对目录结构有明确约定parsers/下每个语言一个语言名.so文件如rust.soqueries/语言名/highlights.scm存放该语言的 tree-sitter 高亮查询。在仓库源码的 data/tree-sitter/queries 目录中已内置 Rust、Python、Bash、C、Markdown 等十余种语言的highlights.scm查询直接复制到你的查询目录即可使用。3. 代码配色方案配置从调色板到语法捕获3.1 配色方案的加载方式代码配色有两层配置入口写在主配置config.toml的[colorscheme]与[colorscheme.syntax]段或单独写一个颜色主题 TOML 文件再通过colorscheme ~/.ad/colorschemes/default_dark.toml指定。仓库内置的默认深色主题在 data/colorschemes/default_dark.toml浅色主题在 data/colorschemes/default_light.toml。3.2 定义调色板让配色复用更优雅ad编辑器 支持先在[palette]中定义具名颜色再在语法捕获里引用修改一处全局生效[palette] bg #1B1720 fg #E6D29E blue #8793B5 cyan #7AA89F green #76946A mint #61DCA5 orange #FFA066 red #C34043 yellow #E6C3843.3 为语法捕获分配颜色核心配置[colorscheme.syntax]段是代码配色的核心每一项对应highlights.scm中的一个捕获名支持fg前景色、bg背景色、bold、italic、underline五种样式属性[colorscheme.syntax] default { fg #E6D29E, bg #1B1720 } keyword { fg #Bf616A } string { fg #61DCA5 } comment { fg #624354, italic true } function { fg #8793B5 } type { fg #9AB292 } number { fg #D27E99 } boolean { fg #DCA561, bold true }此外还有三个特殊捕获名需要留意dot当前选区背景色load/execPlan9 风格的加载/执行文本范围高亮色。3.4 更细粒度的特化捕获配色除了通用捕获名ad编辑器 还支持带点的特化名称实现同一种元素内的细分配色例如 Rust 查询文件中用到的function.macro、function.callfunction.macro { fg #FFA066, italic true } function.operator { fg #716E77 } string.template { fg #61DCA5, bold true } string.regex { fg #336677, italic true } markup.heading { fg #8793B5, bold true } markup.link.url { fg #9CABCA, underline true }Markdown 等富文本格式的高亮全靠这套特化捕获来呈现。4. 编写自定义highlights.scm查询的三大要点如果你想把 nvim-treesitter 的查询文件移植到 ad编辑器请务必遵守以下三点详见 docs/tree-sitter-queries.md不支持自定义谓词像#lua-match?、#contains?这类 neovim 自定义谓词会被直接拒绝需替换为 tree-sitter 内置的#match?重叠匹配取后者与 neovim 一致重叠规则中后匹配的覆盖先匹配的所以具体规则放文件末尾通用规则放开头无注入与缩进支持highlights.scm只负责着色不提供缩进、injection、folds 能力。下面这段取自仓库内置 data/tree-sitter/queries/rust/highlights.scm展示了谓词与特化捕获的正确写法(identifier) variable ; 全大写视为常量 ((identifier) constant (#match? constant ^[A-Z][A-Z%d_]*$)) (const_item name: (identifier) constant) (type_identifier) type (primitive_type) type.builtin (function_item (identifier) function) (macro_invocation macro: (identifier) function.macro) [ (line_comment) (block_comment) ] comment5. 正则高亮备选方案为冷门格式兜底并非所有文件格式都有 tree-sitter 语法解析器ad编辑器 为此提供了正则高亮作为备选其实现位于 src/syntax/re.rs。启用方式是在[filetypes.语言名]中指定re_syntax指向一个正则规则 TOML 文件文件里每个键是捕获名值是正则表达式# ~/.ad/syntax/plumbing-rules.toml comment \\b#.* keyword \\b(data|attr|plumb|arg)\\b function \\b(matches|narrows|from|add|to|set|start|isfile|isdir)\\b然后在主配置里关联文件类型[filetypes.txtar] extensions [txtar] re_syntax ~/.ad/syntax/txtar.toml仓库里data/syntax/下的 plumbing-rules.toml、txtar.toml 就是现成的正则高亮示例。这些规则同样以捕获名输出 token因此颜色依然由[colorscheme.syntax]统一控制无需单独配色。注意正则高亮按行匹配、规则间可能有重叠复杂语法会出错。它定位就是聊胜于无的兜底方案适合注释、关键字这类简单规则。6. 常见问题排查高亮没生效怎么办配置了却没高亮运行:view-logs查看日志确认是否有 TS loaded for rust 之类的初始化记录若提示查询文件读取失败多半是parser_dir/syntax_query_dir路径或.so文件名不对。报unsupported predicates警告查询文件里含 neovim 自定义谓词按上文方法替换为#match?即可。注释颜色不对neovim 的注释查询常带spell标签ad编辑器 会把它当作最终捕获名删掉spell后注释即恢复comment配色。7. 总结ad编辑器 的语法高亮配置体系非常清晰tree-sitter 查询负责划范围colorscheme 配色负责上颜色二者解耦、各有专攻。主流语言用 tree-sitter 精确着色冷门格式用正则高亮兜底配合可复用的调色板与特化捕获短短几行配置就能打造出属于自己的完美代码配色。动手试试把~/.ad/config.toml和highlights.scm调成你喜欢的样子吧【免费下载链接】adan adaptable text editor项目地址: https://gitcode.com/gh_mirrors/ad5/ad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考