Treesitter

解析器文件 treesitter-parsers

vim.treesitter.language.add('python', { path = "/path/to/python.so" })

vim.treesitter.language.register('xml', { 'svg', 'xslt' })

vim.treesitter.language.add('python', { path = "/path/to/python.wasm" })

TREESITTER 查询 treesitter-query

TREESITTER 查询谓词 treesitter-predicates

((identifier) @variable.builtin
  (#eq? @variable.builtin "self"))

((identifier) @variable.builtin (#eq? @variable.builtin "self"))
((node1) @left (node2) @right (#eq? @left @right))

((identifier) @constant (#match? @constant "^[A-Z_]+$"))

((identifier) @foo (#contains? @foo "foo"))
((identifier) @foo-bar (#contains? @foo-bar "foo" "bar"))

((identifier) @foo (#any-of? @foo "foo" "bar"))

((identifier) @variable.builtin
  (#any-of? @variable.builtin "begin" "end")
  (#has-ancestor? @variable.builtin range_expression))

(((field_expression
     (field_identifier) @method)) @_parent
 (#has-parent? @_parent template_method function_declarator))

-- TODO: This is a
-- very long
-- comment (just imagine it)

(((comment)+ @comment)
 (#match? @comment "TODO"))

(((comment)+ @comment)
 (#any-match? @comment "TODO"))

TREESITTER 查询指令 treesitter-directives

((identifier) @foo (#set! type "parameter"))

((identifier) @foo (#set! @foo kind "parameter"))
((node1) @left (node2) @right (#set! type "pair"))
((codeblock) @markup.raw.block (#set! priority 90))

((identifier) @constant (#offset! @constant 0 1 0 -1))

(#gsub! @_node ".*%.(.*)" "%1")

(#trim! @fold)

TREESITTER 查询模式行 treesitter-query-modeline

;; inherits: typescript,jsx
;; extends

;; extends
;;
;; inherits: css

TREESITTER 语法高亮 treesitter-highlight

(parameters (identifier) @variable.parameter)

function f(foo, bar) end

(function_declaration ; [1:1 - 24]
  name: (identifier) ; [1:10 - 10]
  parameters: (parameters ; [1:11 - 20]
    name: (identifier) ; [1:12 - 14]
    name: (identifier))) ; [1:17 - 19]

[
  "if"
  "else"
] @keyword.conditional

hi @comment.c guifg=Blue
hi @comment.lua guifg=DarkBlue
hi link @comment.documentation.java String

(comment) @spell

(fenced_code_block_delimiter @conceal (#set! conceal ""))

"!=" @operator (#set! conceal "≠")

((super_important_node) @superimportant (#set! priority 105))

TREESITTER 语言注入 treesitter-language-injections

VIM.TREESITTER lua-treesitter

TREESITTER 树 treesitter-tree TSTree

TREESITTER 节点 treesitter-node TSNode

a -> b -> c
a:child_with_descendant(c) == b
a:child_with_descendant(b) == b
a:child_with_descendant(a) == nil

Lua 模块：vim.treesitter lua-treesitter-core

vim.wo.foldexpr = 'v:lua.vim.treesitter.foldexpr()'

vim.treesitter.get_parser(bufnr):parse(range)

vim.api.nvim_create_autocmd( 'FileType', { pattern = 'tex',
    callback = function(args)
        vim.treesitter.start(args.buf, 'latex')
        vim.bo[args.buf].syntax = 'on'  -- only if additional legacy syntax is needed
    end
})

Lua 模块: vim.treesitter.language lua-treesitter-language

if vim.treesitter.language.add('markdown') then
  vim.treesitter.start(bufnr, 'markdown')
end

Lua 模块: vim.treesitter.query lua-treesitter-query

vim.bo.omnifunc = 'v:lua.vim.treesitter.query.omnifunc'

for id, node, metadata, match in query:iter_captures(tree:root(), bufnr, first, last) do
  local name = query.captures[id] -- name of the capture in the query
  -- typically useful info about the node:
  local type = node:type() -- type of the captured node
  local row1, col1, row2, col2 = node:range() -- range of the capture
  -- ... use the info here ...
end

for pattern, match, metadata in cquery:iter_matches(tree:root(), bufnr, 0, -1) do
  for id, nodes in pairs(match) do
    local name = query.captures[id]
    for _, node in ipairs(nodes) do
      -- `node` was captured by the `name` capture in the match
      local node_data = metadata[id] -- Node level metadata
      ... use the info here ...
    end
  end
end

Lua 模块：vim.treesitter.languagetree lua-treesitter-languagetree

local parser = vim.treesitter.get_parser(bufnr, lang)

local tree = parser:parse({ start_row, end_row })