← notes

Neovim / LazyVim ショートカット — 基本からプロ技まで

  • Neovim
  • LazyVim
  • チートシート

LazyVim を入れてファイルを開いて保存して <space><space> で探す、くらいはできている。でも「もっと速く書ける人がいるらしい」という人向けのまとめ。全部覚える必要はなくて、1週間に2〜3個ずつ手に馴染ませていくのがいちばん効く。

表記:<space> = LazyVim のリーダーキー、Ctrl+x = コントロール、Alt+x = Option(Meta)。キーはすべて LazyVim の初期設定で実際に動くものだけ載せている。迷ったら <space> を押して待てば which-key が続きを教えてくれる。

1. 考え方:Vim は「動詞 + 対象」の文法

Vim のキーは単語の暗記ではなく、動詞(オペレータ)+数+対象(モーション / テキストオブジェクト) の組み合わせ。動詞を1つ覚えれば、知っている対象すべてに効く。

動詞 意味
d 削除(切り取り)
c 削除して挿入モードへ(書き換え)
y コピー(ヤンク)
> / < インデント / アンインデント
= 自動インデント
gu / gU / g~ 小文字 / 大文字 / 反転
gc コメント切替
対象 意味
w / b / e 次の単語頭 / 前の単語頭 / 単語末
$ / 0 / ^ 行末 / 行頭 / 最初の非空白
iw / aw 単語の中 / 単語+前後の空白
i" / a" "…" の中 / クォートごと
i( / a((ib) 括弧の中 / 括弧ごと
it / at HTML タグの中 / タグごと
ip / ap 段落
t, / f, , の手前まで / , まで

組み合わせの例:

  • ci" … クォートの中身を書き換え(カーソルが " の外にいても、その行の次の "…" に効く)
  • dap … 段落ごと削除
  • yi( … 括弧の中をコピー
  • gUiw … 単語を大文字に
  • >ip … 段落をインデント
  • d3w … 3単語削除
  • ct) … ) の手前まで書き換え
  • gcip … 段落をまとめてコメントアウト

dd cc yy >> gcc のように動詞を2回打つと「その行」。

LazyVim で増えている対象(mini.ai)

LazyVim は mini.ai でテキストオブジェクトを増やしている。ここから一気にプロっぽくなる。

対象 意味 例
if / af 関数の中身 / 関数まるごと(treesitter) daf 関数ごと削除、yaf 関数をコピー
ic / ac クラス vac クラス全体を選択
io / ao ブロック・if・ループ dio if の中身を消す
ia / aa 関数の引数1つ cia 引数を書き換え、daa 引数をカンマごと削除
iq / aq どれかのクォート(" ' `) ciq 種類を気にせず中身を書き換え
ib / ab どれかの括弧(() [] {}) dib
iu / au 関数呼び出し diu 呼び出しの引数を全部消す
id 数字の並び cid
ie camelCase / snake_case の1語 getUserName の User だけ cie
ig / ag バッファ全体 yag 全部コピー、=ag 全体を再インデント
ih git の変更ブロック(gitsigns) vih 変更箇所を選択、yih コピー

2. 移動:hjkl を連打しない

キー 動作
f{c} / t{c} 行内の文字 c へ / c の手前へ。; , で次 / 前
% 対応する括弧へ
{ / } 前 / 次の空行(段落単位)
* / # カーソル下の単語を前方 / 後方検索
gg / G / 42G 先頭 / 末尾 / 42行目
Ctrl+d / Ctrl+u 半画面スクロール
zz / zt / zb カーソル行を画面の中央 / 上 / 下に
Ctrl+o / Ctrl+i ジャンプ履歴を戻る / 進む(gd で飛んだ後に戻る)
g; / g, 最後に編集した場所へ / 逆方向
gi 最後に挿入した場所へ戻って挿入モード
`. 最後に変更した位置
ma / `a マーク a を置く / a へ戻る(mA と大文字にすると別ファイルからも戻れる)

LazyVim では H / L が「前 / 次のバッファ」に変わっている(Vim 本来の「画面の上端 / 下端」ではない)。

flash.nvim:画面のどこへでも3打で

キー 動作
s + 2文字 画面中のその2文字の位置にラベルが出る → ラベルを押すと飛ぶ
S treesitter の範囲(関数・引数・ブロック)にラベル → 押すとその範囲を選択
yr → 2文字+ラベル → 対象 離れた場所をカーソルを動かさずにコピー(remote)。例:yr → 飛び先を選ぶ → iw で、その単語をコピーして元の位置に戻る
d + s 今の位置から飛び先までを削除(s もモーションとして使える)
f / t 後の f flash が効いているので ; の代わりに f を押し続けても次へ進む

treesitter で構造ジャンプ

キー 動作
]f / [f 次 / 前の関数の頭
]c / [c 次 / 前のクラス
]a / [a 次 / 前の引数
]] / [[ カーソル下のシンボルの次 / 前の出現箇所(LSP)
Ctrl+Space 押すたびに選択範囲を構文単位で広げる
選択中の an / in 親 / 子の構文ノードへ選択を広げる / 縮める
選択中の ]n / [n 隣の構文ノードへ選択を移す

] / [ の系列はほかにも ]d 診断、]h git の変更、]q quickfix、]t TODO コメント、]b バッファ。大文字(]D など)は最後 / 最初へ。

3. 編集のプロ技

.(ドットリピート)がすべての基本

. は直前の変更をもう一度。「変更を1回でキレイに作って、あとは .」を意識すると打鍵が激減する。

  • A;<Esc> → j. j. … 複数行の末尾に ;
  • ciwfoo<Esc> → 次の単語に移って . … 単語を次々 foo に
  • >> → . . … 何段もインデント

* → cgn → .:1か所ずつ確認しながら置換

  1. 置換したい単語の上で *(検索して次へ)
  2. cgn で「次の検索ヒット」を書き換え、<Esc>
  3. あとは . を押すたびに次のヒットが同じ内容に置き換わる。飛ばしたいときは n

:%s と違って、目で見ながら1つずつ判断できる。

マクロ:繰り返し作業を録音

キー 動作
qa … q レジスタ a に録音開始 … 終了
@a / @@ 再生 / 直前のマクロをもう一度
20@a 20回再生(途中で失敗すると止まるので、多めに指定して OK)
範囲選択して :norm @a 選択した各行でマクロを実行

コツは**「次の行の同じ位置に移動するところまで」録音する**こと(最後に j0 など)。そうすれば @@ を連打するだけで流れる。

ビジュアルブロックで縦に編集

キー 動作
Ctrl+v 矩形選択
選択して I / A 全行の先頭 / 末尾に同じ文字を入力(<Esc> で反映)
Ctrl+v → $ → A 長さがバラバラな行の末尾にまとめて追加
選択して c 矩形を全行同時に書き換え
0 を縦に並べて選択 → g Ctrl+a 1, 2, 3 … と連番にする
Ctrl+a / Ctrl+x カーソル下(または右)の数字を +1 / −1(10 Ctrl+a で +10)

小技

キー 動作
Alt+j / Alt+k 行(選択範囲)を上下に移動(LazyVim。Mac のターミナルは Option を Meta にする設定が必要)
J / gJ 下の行を連結(空白あり / なし)
xp / ddp 2文字 / 2行を入れ替え
~ 1文字の大文字小文字を反転
gv 直前の選択範囲をもう一度選択
ビジュアル中の o 選択範囲の反対側の端へ移る(範囲を上にも伸ばせる)
gx / gf カーソル下の URL をブラウザで / ファイルパスを開く
g Ctrl+g 文字数・単語数・行数を表示
u / Ctrl+r アンドゥ / リドゥ
<space>su Undotree(分岐したアンドゥ履歴から戻す)
:earlier 10m 10分前の状態に戻す(:later で戻る)

挿入モードを抜けずに済ませる

キー 動作
Ctrl+w / Ctrl+u 直前の単語 / 行頭までを削除
Ctrl+r " ヤンクした内容を貼り付け(Ctrl+r 0 でヤンク専用レジスタ)
Ctrl+r = 60*24 Enter 計算結果(1440)を挿入
Ctrl+o + コマンド ノーマルモードのコマンドを1回だけ実行(Ctrl+o zz など)
Ctrl+s 関数の引数ヒント(LSP)

4. レジスタ:「消したら貼りたいものが消えた」を卒業

d や c で消したものも「コピー」扱いなので、yiw → 別の単語を ciw → p とすると、さっき消した単語が出てきてしまう。

キー 動作
"0p 最後にヤンクしたものを貼る(削除では上書きされない)
"ayy / "ap 名前付きレジスタ a にコピー / a から貼る
"Ayy 大文字にすると a に追記(あちこちの行を集めてから一度に貼る)
"_d ブラックホールに削除(レジスタを汚さない)
<space>s" レジスタの中身を一覧して選んで貼る
:reg レジスタ一覧(:reg a0 で指定のものだけ)

LazyVim は OS のクリップボードと共有済み(clipboard=unnamedplus)なので、y したものはそのまま他のアプリに貼れる。

5. Ex コマンドの必殺技

コマンド 動作
:%s/foo/bar/gc 全体置換、1件ずつ確認(y / n / a 全部 / q 中止)
* のあと :%s//bar/g 検索語を空欄にすると直前の検索を使う(打ち間違いが減る)
:%s/\v(\w+) (\w+)/\2 \1/ \v で正規表現をエスケープ少なめに。単語を入れ替え
:g/TODO/d TODO を含む行をすべて削除
:v/error/d error を含まない行を削除(ログの絞り込み)
:g/^$/d 空行を全部消す
:g/pattern/norm A; マッチした行すべての末尾に ;
:sort / :sort u / :sort n 並べ替え / 重複削除 / 数値順(範囲指定可)
!ip sort 段落を外部コマンドに通して置き換え(!ip jq . で JSON 整形なども)
:r !date コマンドの出力をカーソル下に挿入
@: 直前の : コマンドを再実行
q: コマンド履歴をバッファとして開いて、編集してから Enter で実行
<space>: コマンド履歴をピッカーで

6. 探す・置換する(LazyVim)

キー 動作
<space><space> / <space>fr ファイルを探す / 最近開いたファイル
<space>/ プロジェクト全体を grep
<space>sw カーソル下の単語(または選択範囲)で grep
<space>sb 今のバッファの行を絞り込み検索
<space>ss / <space>sS シンボル(関数・クラス)一覧 / ワークスペース全体
<space>sR 直前のピッカーを再開(さっきの検索結果に戻る)
<space>sj / <space>sm ジャンプ履歴 / マーク一覧
<space>sd / <space>st 診断一覧 / TODO・FIXME 一覧
<space>sk / <space>sh キー割り当て / ヘルプを検索
<space>fc Neovim の設定ファイルを探す
<space>sr プロジェクト全体の検索置換(grug-far。プレビューを見ながら置換できる)

ピッカーの中では Ctrl+q で、絞り込んだ結果を quickfix に送れる。そこから

:cdo s/old/new/g | update

とすれば、grep に引っかかった箇所だけを一括置換して保存できる。]q / [q で quickfix を順に巡回、<space>xQ で一覧表示。

7. ウィンドウ・バッファ

キー 動作
<space>- / <space>| 下 / 右に分割
Ctrl+h/j/k/l ウィンドウ移動
<space>wd ウィンドウを閉じる
<space>wm ウィンドウを最大化 / 元に戻す(分割したまま一時的に集中)
Ctrl+w = 分割サイズを均等に
Ctrl+w Space ウィンドウ操作モード(hjkl で移動・< > + - でサイズ変更を連打できる)
<space>uz Zen モード(周りを全部消して集中)
<space>bd / <space>bo バッファを閉じる / 今のバッファ以外を全部閉じる
<space>bp / <space>bP バッファをピン留め / ピン留め以外を全部閉じる
<space>bj バッファをラベルで選んで移動
<space>, バッファ一覧
Ctrl+/ ターミナルを開く / 隠す
<space>. スクラッチバッファ(メモ用の一時バッファ。保存不要)

8. Git(gitsigns・lazygit)

キー 動作
]h / [h 次 / 前の変更箇所(hunk)
<space>ghp その変更を差分表示
<space>ghs / <space>ghr 変更をステージ / 元に戻す(選択範囲にも効く)
<space>ghb その行を誰がいつ変えたか(blame)
<space>gb その行の変更履歴をピッカーで
<space>gf 今のファイルの変更履歴
<space>gB 今の行を GitHub のページで開く
<space>gd 変更箇所の一覧
<space>gg lazygit(Space ステージ、c コミット、P push、? ヘルプ)

9. LSP(コードを理解するキー)

キー 動作
gd / gD 定義 / 宣言へ
gr 参照一覧
gI / gy 実装 / 型定義へ
K ドキュメントを表示(2回押すとその中に入れる)
<space>ca コードアクション(import 追加・修正候補など)
<space>cr シンボルの名前を一括変更
<space>cR ファイル名を変更(import も追従)
<space>cd その行の診断を全文表示
<space>xx 診断を Trouble で一覧(<space>xX は今のバッファだけ)
<space>cf / <space>uf 整形 / 保存時の自動整形を ON・OFF
<space>uh インレイヒント(型・引数名の表示)を ON・OFF

10. 覚えておくと助かるもの

キー 動作
<space>qs / <space>ql セッション復元(このディレクトリ / 最後のもの)。昨日の続きをウィンドウ配置ごと再開
<space>n 通知の履歴(一瞬で消えたエラーを読み返す)
<space>l / <space>cm Lazy(プラグイン管理)/ Mason(LSP 等の管理)
<space>uC カラースキームをプレビューしながら切り替え
<space>? 今のバッファで使えるキー一覧
:checkhealth 環境の問題を診断
:LazyExtras LazyVim の追加機能を選んで有効化(言語サポート・mini.surround など)

11. マニアック編:ここまで知っていれば上級者

上の内容を「全部知ってる」人向け。毎日は使わないけれど、刺さる場面では他の手段の10倍速い。

置換を式で書く

コマンド 動作
:%s/\d\+/\=submatch(0)*2/g \= で置換先を式で計算。数字を全部2倍に
:%s/^/\=line('.') . '. '/ 行頭に行番号を振る
:%s/\v<(\w)(\w*)>/\u\1\L\2/g 単語をタイトルケースに(\u 次の1文字を大文字、\U \L 以降を大 / 小文字、\E で解除)
:%s/, /\r/g \r で改行に置換(検索側の改行は \n)
:'<,'>s/\%Vfoo/bar/g \%V で矩形選択の中だけを置換(普通の '<,'>s は行全体が対象)
:%s/pat//gn 置換せずにマッチ数だけ数える
& / g& 直前の :s を今の行に / 全行にもう一度
:s/old/~/ ~ は直前の置換後の文字列
:cfdo %s/a/b/g | update quickfix のファイル単位で置換(:cdo はヒット行ごと)

行をコマンドで動かす

コマンド 動作
:t. 今の行を複製(yyp と違ってレジスタを汚さない)
:-5t. 5行上の行を今の行の下にコピー(カーソルを動かさない)
:10,12m$ 10〜12行目を末尾へ移動(m0 で先頭へ)
:g/^/m0 全行を逆順に
:g/pat/t$ マッチした行を末尾に集める(コピー)
:g/^$/,/./-j 連続する空行を1行にまとめる
:g/pat/normal @q マッチした行だけでマクロ q を実行
:'<,'>normal . 選択した各行で . を実行
:sort /^\S\+\s/ マッチ部分を飛ばして残りで並べ替え(:sort r /\d\+/ はマッチ部分で並べ替え)
:'<,'>!column -t 選択範囲を外部コマンドで桁揃え
:%!xxd / :%!xxd -r バイナリを16進で編集して戻す
5: :.,.+4 が自動で入る(今の行から5行分が範囲)

マクロを極める

操作 動作
qaq → qa … @a q 再帰マクロ。先に a を空にしてから、最後で自分自身を呼ぶ。失敗する行まで勝手に回る
"ap → 修正 → 0"ay$ マクロを文字列として編集して書き戻す(録り直さない)
:let @a='0f=r:' マクロを直接書く
Q 最後に録音したマクロを再生(選択中なら各行で)
"qyy を @q 行に書いたコマンドをそのままマクロとして実行

範囲・マーク・特殊レジスタ

キー 動作
`[v`] 直前に貼り付け / 変更した範囲を選択(貼った直後に > したいとき)
`[ / `] 直前の変更範囲の先頭 / 末尾へ
'< / '> 直前の選択範囲の先頭 / 末尾
"%p 今のファイル名を貼る
".p 最後に入力したテキストを貼る
":p 最後の : コマンドを貼る
"/p 最後の検索語を貼る
:let @/='foo' 検索語を直接セット(ハイライトだけしたいとき)
選択して * 選択した文字列で検索(Neovim 0.10+)
dgn 次の検索ヒットを削除(gn は「次の検索ヒット」というテキストオブジェクト)

コマンドラインを速く打つ

キー 動作
Ctrl+r Ctrl+w カーソル下の単語を挿入(:%s/ まで打ってから使う)
Ctrl+r Ctrl+a カーソル下の WORD(空白区切り)を挿入
Ctrl+r / / Ctrl+r " 直前の検索語 / ヤンクを挿入
Ctrl+f 打ちかけのコマンドを編集用ウィンドウで開く(q: と同じ画面、q/ は検索履歴)
%:h / %:t / %:r / %:e 今のファイルのディレクトリ / 名前 / 拡張子なし / 拡張子(:e %:h/new.lua で同じ場所に新規作成)

アンドゥを時間で戻る

コマンド 動作
:earlier 10m / :later 10m 10分前 / 後の状態へ
:earlier 1f 1つ前に保存した時点へ(LazyVim は undofile 有効なので再起動後も効く)
g- / g+ アンドゥ履歴を時系列で前後(分岐した変更にも戻れる)
:changes 変更位置の一覧(g; で巡回する先)

文字・テキスト整形

キー 動作
ga / g8 カーソル下の文字コード / UTF-8 のバイト列を表示
挿入モードで Ctrl+v u3042 Unicode を番号で入力(あ)
gqip / gwip 段落を textwidth で折り返し整形(gw はカーソルが動かない)
Ctrl+v で行末より右へ LazyVim は virtualedit=block なので、文字のない場所まで矩形を伸ばせる
矩形選択中の O 選択の左右の角を入れ替え(o は対角)
[<space> / ]<space> 上 / 下に空行を追加(Neovim 0.11+、5]<space> で5行)

比較・調査・デバッグ

コマンド 動作
:windo diffthis / :diffoff! 分割した2ファイルをその場で diff(]c [c で移動、do 取り込み / dp 送り込み)
:verbose map <space>sr そのキーをどのファイルの何行目で定義したか
:verbose set tabstop? そのオプションを最後に設定した場所
:lua =vim.lsp.get_clients()[1].name = 付きで Lua の値をその場で表示(設定のデバッグ)
:put =execute('messages') メッセージ履歴をバッファに貼る(エラー全文をコピーしたいとき)
:Inspect / :InspectTree カーソル下のハイライト / treesitter の構文木を表示
:Lazy profile 起動が遅いプラグインを調べる
:cq エラー終了(git commit のエディタで使うとコミットを中止できる)
ZZ / ZQ 保存して閉じる / 保存せず閉じる
Ctrl+z → fg Neovim を一時停止してシェルへ、fg で復帰

練習の順番(おすすめ)

  1. ciw ci" ca( dap — テキストオブジェクトに慣れる。これだけで編集速度が変わる
  2. . リピート と * → cgn → .
  3. s(flash) と Ctrl+o — 画面内を自由に飛んで、迷ったら戻る
  4. daf cia yag(mini.ai)と ]f ]h ]d
  5. <space>sw → Ctrl+q → :cdo と <space>sr — プロジェクト規模の置換
  6. マクロ と :g — 「同じことを100回」がゼロ秒になる
  7. "0p "Ayy — レジスタを意識し始めたら中級者卒業

最後に1つ。<space>sk でキーを検索、:help ciw のように :help + キーでその場で調べられる。分からないときに調べる手段が手元にあるのが Vim のいちばん強いところ。