Neovim Treesitter插件导致启动异常缓慢的问题排查与优化求助

你遇到的启动延迟不是Treesitter的正常表现，完全可以通过配置优化解决。结合你的排查结果（插件加载仅20ms，延迟集中在缓冲区打开和首屏更新），问题根源是Treesitter在启动阶段同步执行了语法解析和高亮渲染，阻塞了启动流程。下面是具体优化方案：

1. 延迟Treesitter的加载时机 #

默认情况下如果没有配置触发条件，Treesitter会在Neovim启动时立刻初始化。改成按需加载，比如打开文件后再加载：
在Lazy.nvim的插件配置中，给nvim-treesitter添加event触发条件：

{
  "nvim-treesitter/nvim-treesitter",
  -- 打开已有文件后再加载插件
  event = "BufReadPost",
  build = ":TSUpdate",
  config = function()
    require("nvim-treesitter.configs").setup({
      -- 你的原有配置
    })
  end,
}

2. 开启Treesitter异步高亮 #

把同步的语法高亮改成异步执行，避免阻塞首屏更新：
在Treesitter的setup配置中添加：

require("nvim-treesitter.configs").setup({
  highlight = {
    enable = true,
    -- 禁用Vim原生正则高亮，减少冲突和额外耗时
    additional_vim_regex_highlighting = false,
    -- 开启异步高亮，后台解析不阻塞UI
    async = true,
  },
})

3. 仅安装常用的语法解析器 #

不要用ensure_installed = "all"安装所有解析器，只保留你日常使用的语言，减少启动时的检查和初始化开销：

require("nvim-treesitter.configs").setup({
  -- 替换成你常用的语言，比如Lua、Python、Bash等
  ensure_installed = { "lua", "python", "bash", "markdown" },
  highlight = {
    enable = true,
    -- 其他配置
  },
})

4. 对大文件禁用Treesitter #

如果启动时默认打开的是大文件，Treesitter全量解析会大幅增加耗时。可以设置阈值，超过大小的文件自动用原生高亮：

require("nvim-treesitter.configs").setup({
  highlight = {
    enable = true,
    additional_vim_regex_highlighting = false,
    -- 对大于100KB的文件禁用Treesitter高亮
    disable = function(_, buf)
      local max_filesize = 100 * 1024
      local ok, stats = pcall(vim.loop.fs_stat, vim.api.nvim_buf_get_name(buf))
      return ok and stats and stats.size > max_filesize
    end,
  },
})

5. 升级到最新版Neovim和Treesitter #

Neovim 0.9+版本对Treesitter的异步支持做了不少优化，Treesitter插件的最新版本也修复了很多性能问题。确保你安装的是最新稳定版Neovim，同时通过Lazy.nvim更新Treesitter插件。

以上方案组合使用后，应该能把启动时间压缩到300ms以内，彻底解决你遇到的缓冲区打开和首屏更新延迟问题。

内容的提问来源于stack exchange，提问作者dsa