在bufferline.nvim中实现持久化标签页名称功能

功能背景

在Neovim的日常使用中，标签页管理是提高工作效率的重要工具。许多用户习惯为不同的标签页设置自定义名称以区分工作上下文，但默认情况下这些名称在会话重启后会丢失。bufferline.nvim作为一款流行的标签页管理插件，原生并未提供标签页名称持久化功能。

技术实现方案

核心思路

实现这一功能需要解决两个关键问题：

1. 存储自定义标签页名称
2. 在会话恢复时重新应用这些名称

通过利用Neovim的全局变量(vim.g)和会话管理功能(vim.opt.sessionoptions)可以完美实现这一需求。

具体实现代码

-- 创建重命名命令
vim.api.nvim_create_user_command("BufferLineRename", function(opts)
  local current_tab = vim.api.nvim_get_current_tabpage()
  if opts.args == "" then
    vim.g["BufferLineCustomName" .. current_tab] = nil  -- 清除自定义名称
  else
    vim.g["BufferLineCustomName" .. current_tab] = opts.args  -- 设置自定义名称
  end
end, {
  nargs = "?",  -- 接受可选参数
  desc = "重命名当前标签页",
})

-- 配置bufferline.nvim
require("bufferline").setup({
  options = {
    name_formatter = function(buf)
      -- 优先使用自定义名称
      local custom_name = vim.g["BufferLineCustomName" .. buf.tabnr]
      return custom_name or buf.name  -- 回退到默认名称
    end,
  }
})

-- 添加快捷键映射
vim.keymap.set("n", "<leader>r", function()
  vim.ui.input({ prompt = "新标签页名称: " }, function(input)
    if input then
      vim.cmd("BufferLineRename " .. input)
    end
  end)
end, { desc = "重命名标签页" })

-- 启用全局变量会话持久化
vim.opt.sessionoptions:append("globals")

功能详解

1. 自定义命令：

   • 创建:BufferLineRename命令，支持带参数调用设置名称或不带参数调用重置名称
   • 使用vim.g全局变量存储名称，键名包含标签页ID确保唯一性

2. 名称格式化：

   • 通过name_formatter回调函数检查是否存在自定义名称
   • 存在则返回自定义名称，否则返回默认缓冲区名称

3. 交互优化：

   • 添加<leader>r快捷键提供更友好的输入体验
   • 使用Neovim的vim.ui.input实现交互式输入

4. 会话持久化：

   • 配置sessionoptions包含globals使全局变量在会话间保持

使用场景示例

1. 开发不同项目时，可以为每个标签页命名为对应项目名称
2. 调试代码时，可以命名为"调试会话"等有意义的名称
3. 临时研究某个功能时，可以命名为相关主题便于后续回顾

注意事项

1. 确保已正确配置Neovim的会话管理功能
2. 自定义名称仅对当前标签页有效，不影响其他标签页
3. 重置名称后，将恢复显示默认的缓冲区名称
4. 该实现与bufferline.nvim原生功能完全兼容