Vim/Neovim の画面スクロール方法まとめ (scrolljump, scrolloff, scroll)

画面スクロール操作

画面スクロール

表示位置を移動

下記の操作では、カーソル位置（行）をキープしたまま、画面の表示位置だけを移動させます。

※1 例えば、ソースコードの関数名を定義している行で、z [Enter] とすれば、その関数の定義が画面上端から表示されます。 z コマンドは、scrolloff オプションに 0 以外が設定されていると、その値によって移動後の表示位置が少々変わります。

z コマンドを実行するときに数値プレフィックスを付けると、カレント行とみなす行番号を指定することができます。

30z[Enter]

画面上端、下端でのスクロール方法の設定 (scrolljump, scrolloff)

1 番上の行にカーソルがあるときに、さらに上へカーソルを移動させようとするとスクロールが発生します。 このときのスクロール行数は scrolljump オプションで指定することができます（デフォルトは 1）。

:set scrolljump=1

カーソルが画面の上端、下端まで行く前にスクロールを開始するには、scrolloff オプションで何行残してスクロールを開始するかを指定します（デフォルトは 0）。 この値を 0 以外にしておくと、スクロールが早めに始まるので作業効率が上がります。

:set scrolloff=5

-- Number of context lines to keep above and below the cursor (default: 0).
vim.opt.scrolloff = 10

画面スクロール量の設定 (scroll)

Ctrl-d や Ctrl-u による画面スクロール行数は、scroll オプションで設定できます。 個人的には、一度に画面半分もスクロールされると脳がついていけないので、3 行くらいのスクロールに変更しておくと使いやすいです。

:set scroll=3

ただし、この設定は Vim エディタのウィンドウサイズを変更したタイミングなどでリセットされてしまいます。 そのため、設定ファイルで scroll オプションを設定するときは、下記のように autocmd を使ってバッファ切り替え時に再設定するようにしておくとよいでしょう。

" Number of lines to scroll with CTRL-U and CTRL-D commands.
" scroll 値は自動的に変更されてしまうため、バッファ切替時に再設定しておく。
autocmd BufEnter  *  setlocal scroll=3

vim.api.nvim_create_autocmd("BufEnter", {
  pattern = "*",
  callback = function()
    -- Number of lines to scroll with CTRL-U and CTRL-D commands.
    -- scroll 値は自動的に変更されてしまうため、バッファ切替時に再設定しておく。
    vim.opt_local.scroll = 3
  end,
})

（追記）この scroll オプションの指定は、telescope.nvim プラグインとの相性が悪いようです（telescope のウィンドウを開いたときにエラーが発生します）。 現状この設定はコメントアウトしています。