如何在Neovim中设置terminal-local（终端本地）选项？

'number'选项的作用域说明 #

'number' 本身始终是官方定义的window-local（窗口本地）选项，并没有变成原生的buffer-local或terminal-local选项。你观察到的"在终端缓冲区执行:set nonumber仅对该终端生效、不跟随窗口"的现象，是Neovim对终端缓冲区的内置特殊处理逻辑导致的，和选项本身的作用域无关。

Neovim为每个终端缓冲区维护了一份独立的窗口选项快照，存储number、relativenumber、cursorline、list等常用窗口本地选项的值：

• 当窗口切换到显示某个终端缓冲区时，Neovim会自动把该窗口的对应选项替换为终端快照里存储的值
• 当窗口从终端缓冲区切换到其他缓冲区时，Neovim会先把当前窗口的选项值写回对应终端的快照，再恢复窗口原本的选项配置
  这套机制会让终端相关的窗口选项表现出"跟随终端缓冲区走、不跟随窗口走"的效果，看起来就像选项变成了终端本地的，但本质是自动状态同步的结果。

正确设置终端本地选项的方法 #

不要手动修改'number'等窗口选项的原生作用域，否则会和终端的快照机制冲突，导致切换缓冲区时选项状态混乱。推荐用以下两种方式配置：

• 全局默认配置（推荐）
  用TermOpen自动事件，在终端缓冲区创建时通过setlocal（局部设置，仅对当前加载终端的窗口生效）修改选项，设置的值会自动被终端快照捕获，后续该终端在任意窗口打开都会保留配置：
  Vimscript 示例：

  augroup TerminalCustomOpts
      autocmd!
      autocmd TermOpen * setlocal nonumber norelativenumber nocursorline
  augroup END
  

  Lua 示例（适用于Neovim 0.5及以上版本）：

  vim.api.nvim_create_autocmd("TermOpen", {
    pattern = "*",
    callback = function()
      vim.opt_local.number = false
      vim.opt_local.relativenumber = false
      vim.opt_local.cursorline = false
    end
  })
  

• 针对已打开的单个终端修改配置
  先切换到目标终端所在的窗口，确认当前缓冲区是目标终端后，直接执行setlocal <你要修改的选项>即可，修改后的值会自动同步到该终端的快照，后续切换窗口打开也会生效。

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