← notes
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か所ずつ確認しながら置換
- 置換したい単語の上で
*(検索して次へ)
cgn で「次の検索ヒット」を書き換え、<Esc>
- あとは
. を押すたびに次のヒットが同じ内容に置き換わる。飛ばしたいときは 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 で復帰 |
練習の順番(おすすめ)
ciw ci" ca( dap — テキストオブジェクトに慣れる。これだけで編集速度が変わる
. リピート と * → cgn → .
s(flash) と Ctrl+o — 画面内を自由に飛んで、迷ったら戻る
daf cia yag(mini.ai)と ]f ]h ]d
<space>sw → Ctrl+q → :cdo と <space>sr — プロジェクト規模の置換
- マクロ と
:g — 「同じことを100回」がゼロ秒になる
"0p "Ayy — レジスタを意識し始めたら中級者卒業
最後に1つ。<space>sk でキーを検索、:help ciw のように :help + キーでその場で調べられる。分からないときに調べる手段が手元にあるのが Vim のいちばん強いところ。