neo-tree.nvim切换缓冲区时自动剪切文件/目录问题求助

问题定位 #

这个问题大概率是neo-tree的默认窗口映射与<C-w>系列快捷键冲突，或是配置中误将窗口切换动作绑定到了文件剪切操作导致的。当你用<C-w> l等命令切换回neo-tree窗口时，neo-tree内部的映射触发了文件剪切逻辑，而非单纯的窗口焦点切换。

解决方案 #

1. 检查并修正neo-tree的窗口映射 #

先通过:Neotree mappings命令查看当前neo-tree内的所有映射，确认<C-w>相关键是否被绑定到了cut_to_clipboard这类文件操作。如果是，直接在配置中覆盖这些映射：

require("neo-tree").setup({
  window = {
    mappings = {
      -- 禁用neo-tree默认的<C-w>绑定，避免冲突
      ["<C-w>"] = "noop",
      -- 手动将<C-w>系列窗口切换键绑定到纯窗口操作
      ["<C-w>h"] = "prev_window",
      ["<C-w>l"] = "next_window",
      ["<C-w>j"] = "next_window",
      ["<C-w>k"] = "prev_window",
      ["<C-w>w"] = "toggle_window",
    },
  },
})

2. 排查自动触发剪切的事件配置 #

如果映射没问题，检查filesystem模块的事件绑定，确保没有在窗口获得焦点时触发剪切逻辑：

require("neo-tree").setup({
  filesystem = {
    events = {
      -- 移除或注释掉任何可能在窗口切换时触发的剪切相关事件
      -- 比如：on_window_focus = "cut_node" 这类错误配置
    },
    -- 临时关闭`follow_current_file`测试，该选项可能导致窗口切换时的节点选中行为异常
    follow_current_file = false,
  },
})

3. 调整光标选中行为 #

如果切换窗口时光标落在文件节点上触发了默认剪切，可设置neo-tree在获得焦点时不自动选中节点：

require("neo-tree").setup({
  window = {
    -- 关闭窗口获得焦点时自动选中当前文件的行为
    auto_focus_current_file = false,
  },
})

验证方法 #

修改配置后重启Neovim，打开neo-tree并在右侧打开文件，使用<C-w> l等命令切换回neo-tree窗口，确认是否还会触发文件剪切操作。

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