Emacs tree-sitter 初体验
tags: programming
文章目录
Tree-sitter 简介
Emacs 29 的一大亮点就是原生支持了 tree-sitter(后文简称 ts),它的官网是这么定义的:
Tree-sitter is a parser generator tool and an incremental parsing library.
现在较为流行的编辑器,如 Neovim 都已支持 ts 作为解析库。
在 Emacs 中,之前都是采用正则的方式去解析语言的语法结构,这种方式虽然大多数情况是没有问题的,但主要有以下几个问题:
- 正则比较消耗 CPU,导致对大文件进行高亮时容易导致 Emacs 卡主,参见:Regexp Problems (GNU Emacs Lisp Reference Manual)
- 对于有些语法结构,正则并不能很好的工作,参见:The true power of regular expressions
因此,有了 tree-sitter 这种 parser generator 后,就可以比较方便地写出不同语言的解析器,而且能够保证高效。
安装步骤
由于 tree-sitter 核心部分使用 C 编写,因此 Emacs 默认并不链接它,需要我们先手动安装,不同平台的包管理器一般都有预编译好 ts,可以直接安装,例如:
# macOS
brew install tree-sitter
# Ubuntu
sudo apt install libtree-sitter-dev
# Arch Linux
sudo pacman -S tree-sitter
之后就可以编译 Emacs 了下面是笔者编译 Emacs 时用的命令,供读者参考:
# 国外可以用 https://git.savannah.gnu.org/git/emacs.git
git clone https://gitee.com/mirrors/emacs.git
cd emacs
git checkout emacs-29
git clean -xfd
./autogen.sh
./configure --with-tree-sitter
export CPATH=`xcrun --show-sdk-path`/usr/include:`xcrun --show-sdk-path`/usr/include/libxml2
make -j 4 && make install
编译完 Emacs 后,可以使用如下命令来测试:
(treesit-available-p)
返回 t
则说明配置成功。但到这里安装并没有完成,这只是完成了核心部分,不同语言的解析器需要单独安装,不过幸好社区内已经有人整理好了,
Emacs 默认从 treesit-extra-load-path
指定的路径去加载动态链接库,如果这个值是 nil
,它默认会从 user-emacs-directory
下的 tree-sitter
内加载。
所以在下载好对应平台的压缩包后,可以解压到上面指定的目录内。一般来说,语言和动态链接库名字都是一一对应的,比如 c
对应 libtree-sitter-c.dylib
(Linux 下后缀为 so),所以需要对解压后的内容进行重命名,下面的命令供参考(依赖 fd):
fd -t f dylib --exclude 'libtree*' --exec mv {} libtree-sitter-{/} \;
如果语言和动态链接库名字不对应,可以通过 treesit-load-name-override-list
来配置,比如:
(setq treesit-load-name-override-list
'((c++ "libtree-sitter-cpp" "tree_sitter_cpp")
(js "libtree-sitter-javascript" "tree_sitter_javascript"))
)
在安装完不同语言的动态链接库后,可以使用 (treesit-language-available-p 'c)
这个方式来测试。
在确认指定语言的库安装好后,接下来需要做的是开启 Emacs 对应的 mode,比如 c-mode
对应的 c-ts-mode
,Emacs 为不同的语言重新实现了一个以 ts-mode
结尾的新 mode,在 29 版本中,主要有如下几个:
12 candidates: lisp/progmodes/c-ts-mode.el lisp/progmodes/cmake-ts-mode.el lisp/progmodes/dockerfile-ts-mode.el lisp/progmodes/erts-mode.el lisp/progmodes/go-ts-mode.el lisp/progmodes/java-ts-mode.el lisp/progmodes/json-ts-mode.el lisp/progmodes/ruby-ts-mode.el lisp/progmodes/rust-ts-mode.el lisp/progmodes/typescript-ts-mode.el lisp/textmodes/toml-ts-mode.el lisp/textmodes/yaml-ts-mode.el
为了能够自动打开对应的 ts-mode
,可以通过配置 major-mode-remap-alist
来实现:
(setq major-mode-remap-alist
'((yaml-mode . yaml-ts-mode)
(sh-mode . bash-ts-mode)
(js-mode . js-ts-mode)
(css-mode . css-ts-mode)
(c-mode . c-ts-mode)
(c++-mode . c++-ts-mode)
(c-or-c++-mode . c-or-c++-ts-mode)
(python-mode . python-ts-mode)))
这样在进入 c-mode
时,会自动替换成 c-ts-mode
,到这里 tree-sitter 就算安装成功了。
社区插件
虽然 tree-sitter 还相对较新,但是社区内已经有些基于它实现的包了,比如:
其他的包一般都有 issue 跟踪,比如:
对于 expand-region 的用户,可以通过下面的配置来使用 ts:
(when (treesit-available-p)
(defun my/treesit-mark-bigger-node ()
"https://emacs-china.org/t/treesit-expand-region-el/23406"
(let* ((root (treesit-buffer-root-node))
(node (treesit-node-descendant-for-range root (region-beginning) (region-end)))
(node-start (treesit-node-start node))
(node-end (treesit-node-end node)))
;; Node fits the region exactly. Try its parent node instead.
(when (and (= (region-beginning) node-start) (= (region-end) node-end))
(when-let ((node (treesit-node-parent node)))
(setq node-start (treesit-node-start node)
node-end (treesit-node-end node))))
(set-mark node-end)
(goto-char node-start)))
(add-to-list 'er/try-expand-list 'my/treesit-mark-bigger-node))
现有问题
由于 ts-mode 的支持刚开始,原有 major-mode 的功能并不是都支持了,在笔者的测试中, rust-ts-mode
, json-ts-mode
开启后,高亮会有丢失。
收听方式
反馈
- 对节目有想法或发现内容错误?欢迎来信交流️