第I部: はじめの一歩

RuVim を使い始めるために必要な、最小限の知識をこのパートで身につけます。

モーダル編集の考え方、基本的なカーソル移動、テキストの入力と保存、ファイルの開き方 — これらを押さえれば、RuVim で日常的な編集作業を始められます。Vim 系エディタが初めての方は、ここからスタートしてください。

1. RuVimとは

“I think that it’s extraordinarily important that we in computer science keep fun in computing.” — Alan J. Perlis

1.1 この章で学ぶこと

• RuVim の概要とインストール方法
• 起動と終了の方法
• モードの概念

新しいエディタを学ぶのは、新しい楽器を手に取るようなものです。最初は戸惑いますが、基本さえ押さえれば、あとは自然と指が覚えていきます。この章では RuVim の全体像と、まず最低限必要な「起動・入力・保存・終了」を身につけます。ここをクリアすれば、もう RuVim で実際の仕事を始められます。

1.2 RuVim の概要

RuVim は Ruby で実装された Vim ライクなターミナルエディタです。Ruby 標準ライブラリのみで動作し、Vim の操作感を維持しつつ、Ruby ネイティブな拡張性を備えています。

主な特徴:

• Vim 互換のモーダル編集（Normal / Insert / Visual / Command-line モード）
• Ruby DSL による設定とプラグイン
• 26 言語のシンタックスハイライト
• TSV/CSV/Markdown/JSON/画像の Rich View モード
• Git / GitHub 連携
• ストリーム連携（stdin パイプ、:run、:follow）

1.3 インストール

RuVim は gem としてインストールできます。

gem install ruvim

1.4 起動

ファイルを指定して起動:

ruvim file.txt

ファイル指定なしで起動すると、Vim 風の intro screen が表示されます:

ruvim

複数ファイルを開く:

ruvim file1.txt file2.txt file3.txt

レイアウトを指定して複数ファイルを開く:

ruvim -o file1.txt file2.txt    # 水平分割
ruvim -O file1.txt file2.txt    # 垂直分割
ruvim -p file1.txt file2.txt    # タブ

特定の行から開く:

ruvim +10 file.txt              # 10行目へジャンプ
ruvim + file.txt                # 最終行へジャンプ
ruvim file.txt:10               # path:line 形式でも可
ruvim file.txt:10:5             # path:line:col 形式

1.5 モードの概念

RuVim は Vim と同様に「モーダル」なエディタです。モードによってキーの意味が変わります。

起動直後は Normal mode です。

モードの遷移を図で示すと:

1.6 終了

:q        通常終了（未保存変更があるとエラー）
:q\!       強制終了（未保存変更を破棄）
:wq       保存して終了
:qa       全ウィンドウ/タブを閉じて終了
:qa\!      強制的に全終了
:wqa      全バッファ保存して終了

操作例 — ファイルを開いて保存して終了:

$ ruvim hello.txt
（Normal mode で）
i                    ← Insert mode に入る
Hello, RuVim\!        ← テキストを入力
Esc                  ← Normal mode に戻る
:wq Enter            ← 保存して終了

1.7 サスペンド

全モード共通で Ctrl-z を押すとシェルに戻ります（サスペンド）。fg で復帰できます。

次の章では基本の移動を学びます。h/j/k/l を覚えれば、マウスなしでコード中を自在に移動できるようになります。

2. 基本の移動

“In the beginner’s mind there are many possibilities, but in the expert’s mind there are few.” — Shunryu Suzuki

2.1 この章で学ぶこと

• h/j/k/l による移動
• 行頭・行末への移動
• 単語単位の移動
• バッファの先頭・末尾への移動
• スクロール操作
• カウントの使い方

エディタを使う時間の大半は「読む」と「移動する」に費やされます。効率的な移動を身につけることで、考えたことをすぐにコードに反映できるようになります。Vim の移動コマンドを覚えるのは最初こそ大変ですが、ひとたび指が覚えれば、マウスに手を伸ばす必要がなくなります。

2.2 基本の4方向移動

Normal mode での基本移動:

h    左へ移動
j    下へ移動
k    上へ移動
l    右へ移動

操作例:

Hello, World\!
^（カーソルここ）

l l l l l l
      ^（6回 l を押すとカンマの後の空白へ）

2.3 行内の移動

0    行の先頭（列0）へ移動
$    行の末尾へ移動
^    行頭の最初の非空白文字へ移動

操作例 — インデントされた行での動き:

    def hello
    ^（^ で d の位置へ）
^（0 で先頭の空白へ）
               ^（$ で末尾へ）

2.4 単語単位の移動

w    次の単語の先頭へ
b    前の単語の先頭へ
e    現在の単語（または次の単語）の末尾へ

操作例:

def calculate_total(items)
^
w → calculate_total(items) の c へ
w → ( へ
w → items の i へ
b → ( へ（戻る）
e → f へ（def の末尾）

実際のコードで試してみましょう。以下の Ruby コードで w を繰り返し押すとどうなるかを追ってみます:

# BEFORE: カーソルは result の r 上
result = items.map { |x| x * 2 }

# w を押すたびにカーソルが移動する先:
# result → = → items → . → map → { → | → x → | → x → * → 2 → }

2.5 バッファの先頭・末尾

gg   バッファの先頭行へ移動
G    バッファの末尾行へ移動

カウント付き:

10gg    10行目へ移動
10G     10行目へ移動

2.6 スクロール

Ctrl-d    半ページ下へスクロール
Ctrl-u    半ページ上へスクロール
Ctrl-f    1ページ下へスクロール（PageDown）
Ctrl-b    1ページ上へスクロール（PageUp）
Ctrl-e    カーソルを保ったまま1行下へスクロール
Ctrl-y    カーソルを保ったまま1行上へスクロール

カーソル行の画面位置を制御:

zt    カーソル行を画面の上端に
zz    カーソル行を画面の中央に
zb    カーソル行を画面の下端に

PageUp / PageDown キーも使えます。

2.7 カウント（数値プレフィックス）

多くのコマンドは数値プレフィックスを受け付けます。

5j     5行下へ
3w     3単語先へ
10k    10行上へ
2Ctrl-d  2×半ページ下へ

移動コマンドを覚えたら、次はテキストの入力と基本編集に進みましょう。また、これらの移動コマンドはオペレータとモーションと組み合わせると真価を発揮します。

3. テキストの入力と基本編集

“The scariest moment is always just before you start.” — Stephen King

3.1 この章で学ぶこと

• Insert mode への入り方のバリエーション
• 基本的な削除操作
• 保存操作
• Undo / Redo

テキストを入力できなければエディタとは呼べません。この章では Insert mode の多彩な入り方と、「間違えたら戻す」ための Undo / Redo を学びます。Insert mode への入り方を使い分けるだけで、無駄なカーソル移動がぐっと減ります。

3.2 Insert mode への入り方

i    カーソル位置の前から挿入
a    カーソル位置の後ろから挿入
I    行頭の最初の非空白文字から挿入
A    行末から挿入
o    現在行の下に新しい行を開いて挿入
O    現在行の上に新しい行を開いて挿入

操作例 — 行末にセミコロンを追加:

console.log("hello")
（Normal mode で A を押す）
;
Esc
→ console.log("hello");

操作例 — 行の間に新しい行を追加:

line 1
line 3
（line 1 の上で o を押す）
line 2
Esc
→ line 1
  line 2
  line 3

実践例 — Ruby メソッドに引数を追加:

# BEFORE:
def greet(name)
  puts "Hello, #{name}"
end

# name の後にカーソルを置いて a を押し、", greeting" を入力:
# AFTER:
def greet(name, greeting)
  puts "Hello, #{name}"
end

3.3 Insert mode での操作

文字入力     テキストを挿入
Enter       改行
Backspace   1文字削除（行頭ではインデント削除 or 前の行と結合）
Ctrl-n      buffer words 補完（次候補）
Ctrl-p      buffer words 補完（前候補）
Esc         Normal mode に戻る
Ctrl-c      Normal mode に戻る
矢印キー     カーソル移動

3.4 基本の削除操作（Normal mode）

x     カーソル位置の1文字を削除
X     カーソルの前の1文字を削除
dd    現在行を削除
D     カーソルから行末まで削除

カウント付き:

3x     3文字削除
3dd    3行削除

3.5 その他の編集コマンド

s     カーソル位置の1文字を削除して Insert mode（substitute）
S     行全体を削除して Insert mode
J     現在行と次の行を結合
r{c}  カーソル位置の1文字を {c} に置換
~     カーソル位置の文字の大文字/小文字を切り替え

操作例 — 文字の置換:

Hello
^（カーソルが H 上）
rh
→ hello

3.6 保存

:w              現在のバッファを保存
:w filename     指定したファイル名で保存
:wq             保存して終了
:wqa            全バッファ保存して終了

3.7 Undo / Redo

u       直前の変更を取り消す（Undo）
Ctrl-r  取り消した変更をやり直す（Redo）

操作例:

（元の状態）Hello, World\!
dd           → （行が消える）
u            → Hello, World\!（元に戻る）
Ctrl-r       → （また行が消える）
u            → Hello, World\!（再び戻る）

3.8 永続 Undo

RuVim はデフォルトで undo 履歴 をファイルに保存します。エディタを閉じて再度開いても、undo/redo が使えます。

:set undofile       有効化（デフォルトで有効）
:set noundofile     無効化

undo ファイルの保存先: ~/.local/share/ruvim/undo/（undodir オプションで変更可能）

テキスト入力の基本を身につけたら、次はファイルを開いて編集する方法を学びましょう。

4. ファイルを開いて編集する

“Knowledge is of two kinds. We know a subject ourselves, or we know where we can find information upon it.” — Samuel Johnson

4.1 この章で学ぶこと

• :e でファイルを開く
• :r でファイル内容を挿入する
• :\! でシェルコマンドを実行する
• :help でヘルプを見る
• Ctrl-z でサスペンドする

プログラミングでは複数のファイルを行き来し、外部コマンドの結果を取り込み、ヘルプを参照する、という作業が日常的に発生します。エディタの中からこれらの操作がすべてできるようになると、ターミナルとエディタを何度も切り替える手間がなくなり、作業の流れが途切れにくくなります¹。

4.2 ファイルを開く

:e path/to/file.txt     ファイルを開く
:e\! path/to/file.txt    未保存変更を破棄して開く
:e\!                     現在ファイルを再読み込み（undo/redo クリア）

path:line 形式でファイルを開くと指定行にジャンプ:

:e app.rb:42            42行目にジャンプして開く
:e app.rb:42:10         42行目10列にジャンプして開く

実践例 — エラーメッセージからファイルを開く:

# テスト実行時にエラーが出た:
# test/app_test.rb:42: Expected true but got false

# RuVim 内で:
:e test/app_test.rb:42
# → 42行目にジャンプしてファイルが開く

4.3 ファイル内容やコマンド出力の挿入

:r file.txt             ファイルの内容をカーソル行の下に挿入
:r \!ls                  ls コマンドの出力をカーソル行の下に挿入
:3r file.txt            3行目の下に挿入

4.4 バッファ内容をコマンドに渡す

:w \!wc -l               バッファ全体の行数をカウント
:'<,'>w \!sort           選択範囲をソートコマンドに渡す

4.5 シェルコマンドの実行

:\!ls                    ls を実行（画面を一時的に抜ける）
:\!ruby %                現在のファイルを Ruby で実行（% はファイル名に展開）

実行後「Press ENTER or type command to continue」と表示されるので、Enter を押してエディタに戻ります。

より高度な実行には :run コマンドが使えます:

:run ruby %             Ruby で実行し、出力を [Shell Output] バッファに表示
:run                    直前のコマンドを再実行（または runprg の値を使用）

:run は PTY 経由でリアルタイムにストリーム表示し、Ctrl-C で停止できます。

4.6 ヘルプ

:help                   ヘルプバッファを開く
:help regex             正規表現のヘルプ
:help options           オプションのヘルプ
:help w                 :w コマンドのヘルプ

4.7 サスペンドと復帰

Ctrl-z は全モード共通でシェルにサスペンドします。fg で RuVim に復帰します。

（RuVim 操作中に Ctrl-z）
$ fg    ← RuVim に復帰

第II部: 効率的な編集

基本操作を覚えたら、次は「速さ」です。

オペレータとモーションの組み合わせ、テキストオブジェクト、検索・置換、Visual mode、マクロ — Vim 系エディタの真価はこれらの機能にあります。少数のコマンドの掛け算で、驚くほど多彩な操作が可能になります。このパートを終える頃には、マウスに手を伸ばす回数が激減しているはずです。

5. オペレータとモーション

“Give me a lever long enough and a fulcrum on which to place it, and I shall move the world.” — Archimedes

5.1 この章で学ぶこと

• オペレータ + モーションの文法
• d（削除）、y（ヤンク）、c（変更）、=（インデント）
• ペースト操作

オペレータとモーションの組み合わせは、Vim 系エディタの最も強力な武器です。「何をするか」と「どこまでか」を分離することで、少数のコマンドの掛け合わせから無数の操作を生み出せます。一度この文法を体得すれば、新しいモーションを覚えるたびにすべてのオペレータと組み合わせられる — つまり知識が掛け算で増えていきます。

5.2 オペレータ + モーション文法

Vim/RuVim の最も強力な概念の一つが「オペレータ + モーション」の文法です。

{operator}{motion}

オペレータ（何をするか）:

d    削除（delete）
y    ヤンク（コピー）
c    変更（削除して Insert mode）
=    自動インデント

モーション（どこまで）は基本の移動で学んだ移動コマンドです。

組み合わせの考え方:

5.3 delete オペレータ

dw    次の単語の先頭まで削除
d$    行末まで削除（D と同じ）
d0    行頭まで削除
dj    現在行と次の行を削除
dk    現在行と前の行を削除
dh    左の1文字を削除
dl    右の1文字を削除（x と同じ）
dgg   現在行からバッファ先頭まで削除
dG    現在行からバッファ末尾まで削除
dd    現在行を削除（行全体）

カウント付き:

3dw   3単語分削除
2dd   2行削除
d3j   現在行 + 下3行を削除

5.4 yank オペレータ

yy    現在行をヤンク
yw    次の単語の先頭までヤンク
y$    行末までヤンク（Y と同じ）

5.5 change オペレータ

c は削除した後に Insert mode に入ります。

cw    次の単語までを変更
c$    行末まで変更（C と同じ）
cc    行全体を変更（S と同じ）

操作例 — 単語を書き換える:

Hello World
      ^（W の位置でカーソル）
cw
Universe
Esc
→ Hello Universe

5.6 indent オペレータ

==    現在行を自動インデント
=j    現在行と次の行をインデント
=G    現在行からバッファ末尾までインデント
=gg   現在行からバッファ先頭までインデント

Ruby filetype ではネスト構造に基づく自動インデントが適用されます。詳しくはシンタックスハイライトと言語サポートを参照してください。

5.7 行単位のシフト

>>    現在行を右にシフト（shiftwidth 分）
<<    現在行を左にシフト（shiftwidth 分）

5.8 ペースト

p    カーソルの後ろにペースト
P    カーソルの前にペースト

操作例 — 行の入れ替え:

line A
line B
（line A 上で）
dd      ← line A を削除（unnamed register に保存）
p       ← line B の下にペースト
→ line B
  line A

5.9 実践: Ruby メソッドのリファクタリング

オペレータとモーションを使った実際のリファクタリングのステップを追ってみましょう。

課題: メソッド名を変更し、不要な行を削除し、引数を追加する。

# BEFORE:
def calc_price(items)
  subtotal = items.sum
  tax = subtotal * 0.1
  debug_log(subtotal)
  subtotal + tax
end

ステップ 1: メソッド名を変更 — calc_price の c にカーソルを置いて cw

（calc_price の c にカーソル）
cw                         ← 単語を変更
calculate_price            ← 新しい名前を入力
Esc

ステップ 2: debug_log の行を削除 — debug_log の行に移動して dd

（debug_log の行で）
dd                         ← 行を削除

ステップ 3: 引数を追加 — items の ) の手前にカーソルを置いて i

（) の位置で）
i                          ← Insert mode
, tax_rate
Esc

# AFTER:
def calculate_price(items, tax_rate)
  subtotal = items.sum
  tax = subtotal * 0.1
  subtotal + tax
end

6. テキストオブジェクト

“Simplicity is the ultimate sophistication.” — Leonardo da Vinci

6.1 この章で学ぶこと

• iw/aw（単語）
• ip/ap（段落）
• 引用符やカッコのテキストオブジェクト

テキストオブジェクトは「カーソルが構造の中にあるだけで、その構造全体を選択できる」という画期的な仕組みです。プログラミングでは括弧や引用符で囲まれた構造を頻繁に操作しますが、テキストオブジェクトを使えば「開始位置に移動して、終了位置まで範囲指定して…」という手順が一発で済みます。

6.2 テキストオブジェクトとは

テキストオブジェクトは「構造化された範囲」を指定するモーションの一種です。i は “inner”（内側）、a は “a”（外側、区切り文字を含む）を意味します。オペレータと組み合わせて使います。

6.3 単語オブジェクト

iw    単語（inner word）— 単語本体のみ
aw    単語（a word）— 前後の空白を含む

操作例:

Hello, World\!
       ^（W の位置）
diw → Hello, \!         （World だけ削除）
daw → Hello,\!          （World と前の空白も削除）

6.4 段落オブジェクト

ip    段落（inner paragraph）— 空行に囲まれた段落
ap    段落（a paragraph）— 後続の空行を含む

6.5 引用符オブジェクト

i"    ダブルクォートの内側
a"    ダブルクォートを含む範囲
i`    バッククォートの内側
a`    バッククォートを含む範囲

操作例:

puts "Hello, World\!"
            ^（o の位置）
ci"           ← 引用符の中身を変更
Goodbye
Esc
→ puts "Goodbye"

6.6 カッコオブジェクト

i)    丸括弧の内側（ i( と同じ ）
a)    丸括弧を含む範囲
i]    角括弧の内側
a]    角括弧を含む範囲
i}    波括弧の内側
a}    波括弧を含む範囲

操作例:

calculate(x + y)
           ^（カーソルが中に）
di)    → calculate()        （中身だけ削除）
da)    → calculate          （括弧ごと削除）
yi)    → x + y がヤンクされる
ci)    → calculate() の中身を書き換え可能

6.7 実践: HTML タグ内の編集

テキストオブジェクトはコード編集で威力を発揮します。

<\!-- BEFORE -->
<div class="container">
  <p>古いテキスト</p>
</div>

古いテキスト の中にカーソルがあるとき:

ci"           ← class 属性値を変更（" の中にカーソルがある場合）
wrapper
Esc
→ <div class="wrapper">

6.8 実践: 関数の引数を丸ごと書き換え

# BEFORE:
result = process_data(old_arg1, old_arg2, old_arg3)

# 括弧内のどこかにカーソルがある状態で:
ci)
new_arg1, new_arg2
Esc

# AFTER:
result = process_data(new_arg1, new_arg2)

6.9 オペレータとの組み合わせ一覧

7. 行内の高速移動

“It is not enough to be busy. The question is: what are we busy about?” — Henry David Thoreau

7.1 この章で学ぶこと

• f/F/t/T による行内文字検索
• ; と , による繰り返し
• % による括弧マッチング

行の中での移動に h や l を連打するのは非効率です。f/t を使えば、行内の任意の文字に一瞬でジャンプできます。特にプログラミングでは括弧やカンマ、ドットなど、目印になる文字が豊富にあるため、これらのコマンドが非常に強力に働きます。

7.2 行内文字検索

f{char}    行内で次の {char} へ移動（on）
F{char}    行内で前の {char} へ移動（on）
t{char}    行内で次の {char} の手前へ移動（till）
T{char}    行内で前の {char} の直後へ移動（till）

操作例:

def calculate_total(items, tax)
^
f(    → ( へ移動
fi    → items の i へ移動

7.3 繰り返しと逆方向

;    直前の f/F/t/T を同方向に繰り返す
,    直前の f/F/t/T を逆方向に繰り返す

操作例:

one, two, three, four
^
f,    → 最初のカンマへ
;     → 2番目のカンマへ
;     → 3番目のカンマへ
,     → 2番目のカンマへ（逆方向）

7.4 オペレータとの組み合わせ

f/t はモーションなのでオペレータと組み合わせられます。

df)    ) まで削除（) を含む）
dt)    ) の手前まで削除（) は残る）
cf,    , まで変更

実践例 — メソッドチェーンの一部を削除:

# BEFORE:
result = data.select { |x| x > 0 }.map { |x| x * 2 }.sum

# .map の . にカーソルを置いて:
dt.    → .sum の手前まで削除

# AFTER:
result = data.select { |x| x > 0 }.sum

7.5 括弧マッチング

%    対応する括弧へジャンプ（(), [], {}）

操作例:

if (x > 0) {
   ^（( の位置）
%  → ) へジャンプ
%  → ( へ戻る

カーソルが { 上にあれば対応する } へ、} 上にあれば対応する { へジャンプします。

8. 検索と置換

“The art of being wise is the art of knowing what to overlook.” — William James

8.1 この章で学ぶこと

• / と ? による検索
• n/N による検索の繰り返し
• */# によるカーソル下単語の検索
• :substitute による置換
• :global / :vglobal

大規模なコードベースで目的のコードを素早く見つけ出す力は、開発速度に直結します。検索と置換を使いこなせば、変数名のリネームやパターンの一括変更など、手作業では何分もかかる作業を数秒で完了できます。

8.2 検索

/pattern    前方検索（下方向）
?pattern    後方検索（上方向）
n           同方向に次のマッチへ
N           逆方向に次のマッチへ

検索パターンは Ruby 正規表現です¹。

操作例:

/def        "def" を前方検索
n           次の "def" へ
N           前の "def" へ
/\d+        数字の連続を検索
/TODO|FIXME TODO または FIXME を検索

検索ハイライトを一時的に消す:

:nohlsearch    （または :noh）

8.3 カーソル下単語の検索

*     カーソル下の単語を前方検索（単語境界つき）
#     カーソル下の単語を後方検索（単語境界つき）
g*    カーソル下の単語を前方検索（部分一致）
g#    カーソル下の単語を後方検索（部分一致）

操作例 — 変数の使用箇所を探す:

total = items.sum
^（total にカーソル）
*        → 次の "total" へジャンプ（単語境界つき）
n        → さらに次の "total" へ

8.4 検索オプション

:set ignorecase      大文字小文字を無視
:set smartcase       ignorecase 有効時、大文字を含むパターンは case-sensitive
:set hlsearch        マッチをハイライト表示（デフォルト有効）
:set incsearch       入力中にインクリメンタル検索

8.5 置換 (:substitute)

基本形:

:s/old/new/           現在行の最初のマッチを置換
:s/old/new/g          現在行の全マッチを置換
:%s/old/new/g         バッファ全体の全マッチを置換
:10,20s/old/new/g     10-20行の全マッチを置換
:'<,'>s/old/new/g     Visual 選択範囲の全マッチを置換

フラグ:

g    行内の全マッチを置換（グローバル）
i    大文字小文字を無視
I    大文字小文字を区別
n    置換せずマッチ数を表示
e    マッチなし時のエラーを抑制
c    確認モード（y/n/a/q/l/Esc で対話的に判断）

操作例 — 確認付き置換:

:%s/foo/bar/gc

各マッチで y（置換する）、n（スキップ）、a（残り全部置換）、q（中止）、l（これだけ置換して終了）を選べます。

操作例 — Ruby 正規表現の利用:

:%s/(\w+), (\w+)/\2, \1/g     引数の順番を入れ替え
:%s/\bfoo\b/bar/g              単語境界つきで置換

8.6 実践: 変数名のリネーム

プロジェクト内で変数名を user_name から username に変更する実践例:

# BEFORE:
def create_user(user_name, email)
  validate_user_name(user_name)
  user = User.new(user_name: user_name, email: email)
  log("Created user: #{user_name}")
  user
end

ステップ 1: まず確認付きで置換を実行:

:%s/user_name/username/gc

各マッチで確認しながら置換:

• user_name (引数名) → y で置換
• validate_user_name → n でスキップ（メソッド名は別）
• user_name: (キー) → n でスキップ（シンボルはそのまま）
• user_name (値) → y で置換
• …

ステップ 2: 単語境界を使って正確にマッチ:

:%s/\buser_name\b/username/gc

こうすると validate_user_name の部分一致を避けられます。

# AFTER:
def create_user(username, email)
  validate_user_name(username)
  user = User.new(user_name: username, email: email)
  log("Created user: #{username}")
  user
end

8.7 :global / :vglobal

パターンにマッチする行（またはしない行）に対して Ex コマンドを実行します。

:g/pattern/command      マッチ行にコマンドを実行
:v/pattern/command      非マッチ行にコマンドを実行
:g\!/pattern/command     :v と同じ

操作例:

:g/TODO/d               TODO を含む行を全削除
:v/important/d          important を含まない行を全削除
:g/^$/d                 空行を全削除
:g/pattern/p            マッチ行を表示（hit-enter prompt）
:g/def/normal A;        def を含む行の末尾にセミコロン追加

実践例 — ログレベルの整理:

# DEBUG ログを一括削除:
:g/logger\.debug/d

# puts デバッグを一括削除:
:g/^\s*puts /d

# コメントアウトされた行を一括削除:
:g/^\s*#/d

9. Visual mode

“Vision is the art of seeing what is invisible to others.” — Jonathan Swift

9.1 この章で学ぶこと

• 文字単位・行単位・ブロック単位の選択
• 選択範囲に対する操作
• テキストオブジェクトによる選択

Visual mode は「先に範囲を見て確認してから操作する」という安心感のある編集スタイルを提供します。オペレータ+モーションに慣れるまでの橋渡しとしても優れていますし、熟練者にとっても矩形選択などの独自の強みがあります。

9.2 Visual mode の3種類

v        文字単位の選択（characterwise）
V        行単位の選択（linewise）
Ctrl-v   矩形選択（blockwise）

9.3 文字単位の選択（v）

v        選択開始
（移動キーで範囲を広げる）
y        選択範囲をヤンク
d        選択範囲を削除
=        選択範囲を自動インデント
Esc      選択解除

操作例 — 単語を選択してヤンク:

Hello, World\!
^
v        ← 選択開始
e        ← 単語末まで（Hello を選択）
y        ← ヤンク

9.4 行単位の選択（V）

V        行選択開始
j/k      行を追加/削除
d        選択行を全削除
y        選択行をヤンク

操作例 — 3行削除:

V        ← 現在行を選択
jj       ← 下2行も選択
d        ← 3行削除

9.5 矩形選択（Ctrl-v）

Ctrl-v   矩形選択開始
h/j/k/l  矩形を調整
y        矩形範囲をヤンク
d        矩形範囲を削除

実践例 — コメントの一括追加・削除:

# BEFORE: 複数行のコードの先頭にある # を削除したい
# line_one = 1
# line_two = 2
# line_three = 3

# 手順:
# 1. 最初の # にカーソルを合わせる
# 2. Ctrl-v で矩形選択開始
# 3. jj で3行を選択
# 4. l で # と空白を含める
# 5. d で削除

# AFTER:
line_one = 1
line_two = 2
line_three = 3

9.6 Visual mode でのテキストオブジェクト

Visual mode 中にテキストオブジェクトを使うと、選択範囲がそのオブジェクトに更新されます。

v        ← 選択開始
iw       ← 単語を選択

操作例 — 括弧の中身を選択してヤンク:

func(arg1, arg2)
       ^（カーソルが中に）
vi)      ← 括弧の中身を選択（arg1, arg2）
y        ← ヤンク

9.7 Visual mode でのインデント

V        行選択
jj       範囲を広げる
>>       右にシフト
<<       左にシフト
=        自動インデント

Visual 選択中の > や < で範囲のインデントを調整できます。

10. ドットリピート・マクロ・レジスタ

“We are what we repeatedly do. Excellence, then, is not an act, but a habit.” — Will Durant

10.1 この章で学ぶこと

• . による直前操作の繰り返し
• マクロの記録と再生
• レジスタの使い方

繰り返し作業を効率化する仕組みは、エディタの真価を発揮するポイントです。. コマンドは「直前と同じことをもう一回」、マクロは「一連の操作をまるごと再生」。これらを使いこなすと、100行の定型的な変更も数秒で完了できるようになります。

10.2 ドットリピート（.）

. は直前の変更コマンドを繰り返します。

対応コマンド:

• x, dd, d{motion}
• p, P
• r{char}
• i/a/A/I/o/O + Insert 入力
• cc, c{motion}

操作例 — 複数の行末にセミコロンを追加:

console.log("hello")
console.log("world")
console.log("\!")

（1行目で）
A;Esc     ← 行末に ; を追加
j.        ← 次の行で繰り返す
j.        ← さらに次の行で繰り返す

操作例 — 同じ単語を次々と削除:

/word     ← 検索
dw        ← 最初の word を削除
n.        ← 次のマッチに移動して削除
n.        ← さらに次も

10.3 マクロ

マクロは一連のキー操作を記録し、再生する仕組みです。

q{reg}    レジスタ {reg} にマクロ記録開始
（操作を実行）
q         記録停止
@{reg}    マクロ {reg} を再生
@@        直前のマクロを再生

レジスタは a-z, A-Z（追記）, 0-9 が使えます。

操作例 — 各行を括弧で囲むマクロ:

hello
world
foo

（1行目で）
qa        ← レジスタ a に記録開始
I(Esc     ← 行頭に ( を挿入
A)Esc     ← 行末に ) を挿入
j         ← 次の行へ
q         ← 記録停止

@a        ← 2行目で再生
@@        ← 3行目で再生（直前マクロ）

カウント付きの再生:

10@a      マクロ a を10回再生

10.4 実践: マクロで20行のデータを整形する

CSVデータの各行を SQL INSERT 文に変換する例:

# BEFORE (data.csv):
Alice,30,tokyo
Bob,25,osaka
Charlie,35,nagoya
... (20行)

# 目標:
INSERT INTO users VALUES ('Alice', 30, 'tokyo');
INSERT INTO users VALUES ('Bob', 25, 'osaka');
...

マクロの記録 (1行目にカーソルを置いて):

qa                           ← 記録開始
IINSERT INTO users VALUES ('Esc  ← 行頭に追加
f,                           ← 最初のカンマへ
s', Esc                      ← カンマを ', に変更
f,                           ← 次のカンマへ
s, 'Esc                      ← カンマを , ' に変更
A');Esc                      ← 行末に追加
j0                           ← 次の行の先頭へ
q                            ← 記録停止

再生:

19@a                         ← 残り19行に適用

10.5 レジスタ

RuVim にはテキストを保存する複数のレジスタがあります。

レジスタの指定:

"ayy      レジスタ a に行をヤンク
"Ayy      レジスタ a に追記ヤンク
"ap       レジスタ a からペースト
"+yy      システムクリップボードに行をヤンク
"+p       システムクリップボードからペースト
"_dd      行を削除するが、どのレジスタにも保存しない

操作例 — 2つのテキストを入れ替え:

（テキスト A の単語上で）
"adiw     ← レジスタ a にヤンクして削除
（テキスト B の単語上で）
"bdiw     ← レジスタ b にヤンクして削除
"aP       ← レジスタ a をペースト（元の B の位置に A が入る）
（元の A の位置に移動）
"bP       ← レジスタ b をペースト（元の A の位置に B が入る）

11. マークとジャンプリスト

“A good traveler has no fixed plans, and is not intent on arriving.” — Lao Tzu

11.1 この章で学ぶこと

• マークの設定とジャンプ
• ジャンプリストの活用

コードを読む作業は「あちこちを行き来する旅」のようなものです。関数の定義を確認して呼び出し元に戻り、テストを見て実装に戻る — この往復を効率化するのがマークとジャンプリストです。「さっき見ていた場所」にワンキーで戻れる安心感は、コードリーディングの質を大きく変えます。

11.2 マークの設定

m{a-z}    バッファローカルマークを設定（小文字）
m{A-Z}    グローバルマークを設定（大文字）

小文字マークはバッファごとに独立です。大文字マークは全バッファ共通で、別のバッファにいても一発でジャンプできます。

11.3 マークへのジャンプ

'{mark}     マーク行の先頭非空白文字へジャンプ（行単位）
`{mark}     マークの正確な位置へジャンプ

操作例:

（重要なコードの行で）
ma           ← マーク a を設定

（別の場所に移動して作業...）

'a           ← マーク a の行へ戻る
`a           ← マーク a の正確な位置へ戻る

実践例 — テストと実装の間を行き来する:

# 実装ファイル (app.rb) を編集中に:
mA           ← グローバルマーク A を設定

# テストファイルを開く:
:e test/app_test.rb
mB           ← グローバルマーク B を設定

# 以後、いつでも:
'A           ← 実装ファイルのマーク位置へ
'B           ← テストファイルのマーク位置へ

11.4 ジャンプリスト

gg, G, 検索、バッファ切替などの「大きな移動」はジャンプリストに記録されます。

Ctrl-o    前の位置へ戻る（older）
Ctrl-i    次の位置へ進む（newer）
''        行単位で前の位置へ戻る
``        正確な位置で前の位置へ戻る

操作例 — 定義とリファレンスを行き来する:

（関数の呼び出し箇所にいる）
*            ← カーソル下の単語を検索（ジャンプ）
（定義を確認）
Ctrl-o       ← 元の位置に戻る

12. その他の便利な編集コマンド

“The right tool for the right job.” — English Proverb

12.1 この章で学ぶこと

• 1文字操作（r, ~, s, S）
• 行結合（J）
• gf によるファイルジャンプ
• 範囲コマンド
• :filter によるフィルタリング

エディタの強みは「適切な場面で適切なコマンドを選べること」です。この章で紹介する小技の数々は、一つ一つは地味でも、日常の編集で何度も使うものばかりです。特に gf はファイル間の移動を劇的に高速化し、コードリーディングの強力な味方になります。

12.2 1文字操作

r{char}    カーソル位置の文字を {char} に置換
~          大文字/小文字切り替え
s          カーソル位置を削除して Insert mode
S          行全体を削除して Insert mode（cc と同じ）
X          カーソル前の1文字を削除

12.3 行結合

J    現在行と次の行をスペースで結合

操作例:

Hello,
World\!
（Hello, の行で J）
→ Hello, World\!

実践例 — 複数行の配列を1行にまとめる:

# BEFORE:
items = [
  "apple",
  "banana",
  "cherry"
]

# items の次の行にカーソルを置いて 3J:
# AFTER:
items = [
  "apple", "banana", "cherry"
]

12.4 gf — ファイルジャンプ

gf    カーソル下のファイル名を開く

• file:line 形式で開くと指定行にジャンプ
• file:line:col 形式で開くと指定行・桁にジャンプ
• http:// / https:// で始まる URL はブラウザで開く
• Markdown では [text](path) のリンクを認識

path オプションと suffixesadd オプションでファイル探索ディレクトリと拡張子補完を設定できます。

実践例 — require 文からファイルを開く:

require_relative "lib/parser"
# ↑ "lib/parser" にカーソルを合わせて gf
# → lib/parser.rb が開く（suffixesadd に .rb が設定されている場合）

12.5 範囲コマンド

Ex コマンドには行範囲を指定できます。

:10,20d           10-20行を削除
:10,20y           10-20行をヤンク
:10,20s/a/b/g     10-20行で置換
:.,$d             現在行から最終行まで削除
:1,.d             先頭行から現在行まで削除
:%d               バッファ全体を削除（% は 1,$ の略）
:'<,'>d           Visual 選択範囲を削除

その他の範囲コマンド:

:{range}m {addr}    行を {addr} の後ろに移動
:{range}t {addr}    行を {addr} の後ろにコピー
:{range}j           行を結合
:{range}>           右シフト
:{range}<           左シフト
:{range}normal {keys}   各行で Normal mode コマンドを実行

操作例 — 範囲の行を末尾に移動:

:5,10m$     5-10行を末尾に移動
:5,10t0     5-10行を先頭にコピー

12.6 g/ — フィルタバッファ

g/ キーバインド（または :filter）は、検索パターンにマッチする行だけを集めたフィルタバッファを作成します。

/pattern         まず検索
g/               マッチ行のフィルタバッファを作成

:filter /TODO/   パターンを指定してフィルタ

• フィルタバッファ上で Enter を押すと、元バッファの該当行にジャンプ
• フィルタバッファ上で再度 g/ を使うと再帰的に絞り込み可能
• :q でフィルタバッファを閉じて前のバッファに戻る

12.7 スペルチェック

:set spell       スペルチェックを有効化
]s               次のスペルミスへジャンプ
[s               前のスペルミスへジャンプ
:set nospell     無効化

gitcommit filetype ではデフォルトで有効です。辞書は /usr/share/dict/words を使用します。

第III部: 複数ファイルとワークフロー

実際の開発では、1つのファイルだけで完結することはほとんどありません。

バッファ、ウィンドウ分割、タブページを使いこなして複数ファイルを同時に扱い、quickfix や grep で検索結果を一覧し、Git / GitHub 連携でバージョン管理まで — エディタの中だけで開発ワークフローを完結させる方法を学びます。

13. バッファ管理

“Order and simplification are the first steps toward the mastery of a subject.” — Thomas Mann

13.1 この章で学ぶこと

• バッファの一覧と切り替え
• arglist（引数リスト）
• hidden オプション

実際のプロジェクトでは、ソースコード、テスト、設定ファイルなど多数のファイルを同時に扱います。バッファ管理を理解すると、開いたファイルを閉じずにメモリに保持したまま自由に行き来できるようになり、「あのファイルどこだっけ」と迷うことがなくなります。

13.2 バッファとは

RuVim ではファイルを開くと「バッファ」として管理されます。バッファは画面に表示されていなくてもメモリ上に保持できます。

13.3 バッファ一覧

:ls        バッファ一覧を表示
:buffers   :ls と同じ

表示例:

  1 %a + "file1.txt"
  2 #    "file2.txt"
  3      "file3.txt"

フラグ: % = 現在, # = 直前, + = 変更あり

13.4 バッファ切り替え

:bnext       次のバッファへ（:bn）
:bprev       前のバッファへ（:bp）
:buffer 2    バッファ ID 2 へ切替（:b 2）
:buffer #    直前のバッファへ切替
:buffer foo  名前に "foo" を含むバッファへ切替

未保存変更がある場合:

:bnext\!      変更を無視して切替
:buffer\! 2   変更を無視して切替

13.5 バッファの削除

:bdelete     現在バッファを一覧から削除（:bd）
:bdelete\!    未保存変更を破棄して削除
:bdelete 3   バッファ ID 3 を削除

13.6 arglist（引数リスト）

起動時に複数ファイルを指定すると arglist が初期化されます。

ruvim file1.txt file2.txt file3.txt

:args        arglist を表示（現在のファイルは [filename] 形式）
:next        arglist の次のファイルへ
:prev        arglist の前のファイルへ
:first       arglist の最初へ
:last        arglist の最後へ

13.7 hidden オプション

:set hidden    未保存バッファを残したまま別バッファに移動可能に

13.8 autowrite オプション

:set autowrite    バッファ切替時に変更があれば自動保存

14. ウィンドウ分割

“Divide each difficulty into as many parts as is feasible to solve it.” — Rene Descartes

14.1 この章で学ぶこと

• 水平/垂直分割
• ウィンドウ間の移動
• ウィンドウのサイズ調整とクローズ
• ネスト分割

テストを書きながら実装を見たい。ログを監視しながらコードを書きたい。ウィンドウ分割を使えば、画面を分割して複数のファイルを同時に見ることができます。1つのターミナルの中で完結するため、tmux や別のターミナルウィンドウを用意する必要がありません。

14.2 ウィンドウの分割

:split       水平分割（上下）
:vsplit      垂直分割（左右）

分割すると、同じバッファを2つのウィンドウで表示します。それぞれ独立したカーソル位置とスクロール位置を持ちます。

別のファイルを分割して開くには:

:split other.txt
:vsplit other.txt

実践例 — テストと実装を並べて表示:

:e lib/parser.rb              ← 実装ファイルを開く
:vsplit test/parser_test.rb   ← テストファイルを右に分割表示

┌──────────────────┬──────────────────┐
│ lib/parser.rb    │ test/parser_test │
│                  │ .rb              │
│ def parse(input) │ def test_parse   │
│   ...            │   assert_equal(  │
│ end              │     expected,    │
│                  │     parse(input) │
│                  │   )              │
│                  │ end              │
└──────────────────┴──────────────────┘

14.3 ウィンドウ間の移動

Ctrl-w w     次のウィンドウへ
Ctrl-w h     左のウィンドウへ
Ctrl-w j     下のウィンドウへ
Ctrl-w k     上のウィンドウへ
Ctrl-w l     右のウィンドウへ

14.4 ウィンドウのクローズ

Ctrl-w c     現在ウィンドウを閉じる
:q           現在ウィンドウを閉じる（最後のウィンドウなら終了）
Ctrl-w o     他の全ウィンドウを閉じる

14.5 ウィンドウのサイズ調整

Ctrl-w +     高さを増やす
Ctrl-w -     高さを減らす
Ctrl-w >     幅を増やす
Ctrl-w <     幅を減らす
Ctrl-w =     全ウィンドウのサイズを均等化

14.6 分割方向の制御

:set splitbelow     :split 時に下に分割
:set splitright     :vsplit 時に右に分割

14.7 ネスト分割

RuVim はツリー構造のレイアウトをサポートしています¹。:vsplit 後に :split すると、右ウィンドウだけが上下に分割されます。

同方向の連続分割は自動的にフラット化されます。

15. タブページ

“A place for everything, and everything in its place.” — Benjamin Franklin

15.1 この章で学ぶこと

• タブの作成と移動
• CLI からの複数タブ起動

ウィンドウ分割は「同時に見比べたいファイル」に向いていますが、タブは「作業のコンテキストを切り替える」のに適しています。たとえば、「機能Aの実装」タブと「機能Bのレビュー」タブを分けておけば、頭の切り替えもスムーズです。

15.2 タブの操作

:tabnew          新しいタブを作成
:tabnew file.txt ファイルを開いた新しいタブを作成
:tabnext         次のタブへ（:tabn）
:tabprev         前のタブへ（:tabp）
:tabs            タブ一覧を表示

タブが2つ以上あるとき、statusline に tab:n/m と表示されます。

15.3 タブを閉じる

:q     最後のウィンドウなら現在タブを閉じる

15.4 CLI からのタブ起動

ruvim -p file1.txt file2.txt file3.txt

-p で各ファイルを別タブで開きます。

分割で開く場合:

ruvim -o file1.txt file2.txt    # 水平分割
ruvim -O file1.txt file2.txt    # 垂直分割

15.5 タブとウィンドウの関係

各タブは独立した:

• ウィンドウリスト
• 現在ウィンドウ
• 分割レイアウト

を持ちます。バッファはタブ間で共有されます。

16. 検索ワークフロー

“If you can’t find it, you can’t fix it.” — Software Engineering Proverb

16.1 この章で学ぶこと

• quickfix list と location list
• :vimgrep / :grep による検索
• :filter による絞り込み
• スペルチェック

バグの原因を追いかけるとき、リファクタリングで影響範囲を確認するとき、検索ワークフローが武器になります。quickfix list を使えば、プロジェクト全体の検索結果を一覧にして、一つずつ確認しながらジャンプできます。手動でファイルを開いて grep するよりも格段に速く、見落としも減ります。

16.2 quickfix list

quickfix list は検索結果やエラー一覧を保持するリストです。

:vimgrep /pattern/     開いているバッファ群から検索して quickfix に
:copen                 quickfix list を表示
:cnext (:cn)           次の項目へジャンプ
:cprev (:cp)           前の項目へジャンプ
:cclose                quickfix list を閉じる

Normal mode のショートカット:

Q      :copen 相当
]q     :cnext 相当
[q     :cprev 相当
Enter  quickfix バッファ上で選択項目へジャンプ

実践例 — プロジェクト内の TODO を確認:

:grep TODO lib/*.rb          ← lib 以下の Ruby ファイルから TODO を検索
Q                            ← quickfix list を開く
（結果の一覧が表示される）
Enter                        ← 選択した結果へジャンプ
]q                           ← 次の結果へジャンプ
[q                           ← 前の結果へ戻る

16.3 location list

location list はウィンドウローカルな quickfix list です。

:lvimgrep /pattern/    現在バッファ内を検索して location list に
:lopen                 location list を表示
:lnext (:ln)           次の項目へジャンプ
:lprev (:lp)           前の項目へジャンプ
:lclose                location list を閉じる

16.4 外部 grep

:grep pattern [files...]     外部 grep を実行 → quickfix
:lgrep pattern [files...]    外部 grep を実行 → location list

grep プログラムは grepprg オプションで設定できます（デフォルト: grep -nH）。

操作例:

:grep TODO *.rb          Ruby ファイルから TODO を検索
:grep -i error lib/**    lib 以下を case-insensitive 検索

ワイルドカードは Ruby の Dir.glob で展開されます。

16.5 :filter による絞り込み

/pattern     まず検索
g/           マッチ行のフィルタバッファを作成

フィルタバッファでは:

• Enter で元バッファの該当行へジャンプ
• 再度 g/ で再帰的に絞り込み
• :q で閉じて戻る

16.6 スペルチェック

:set spell     スペルチェック有効化
]s             次のスペルミスへ
[s             前のスペルミスへ
:set nospell   無効化

17. Git 連携

“Those who cannot remember the past are condemned to repeat it.” — George Santayana

17.1 この章で学ぶこと

• Git コマンドの使い方
• blame, status, diff, log, branch, commit, grep

バージョン管理はソフトウェア開発の基盤です。エディタの中から直接 Git を操作できると、「コードを書く → 差分を確認 → コミットする」という流れが途切れません。blame で「誰がなぜこう書いたか」を即座に調べられるのも、コードの理解に大きく貢献します。

17.2 Git コマンドへのアクセス

Ctrl-g    ":git " がプリセットされたコマンドラインに入る
:git <subcmd>    Git サブコマンドを実行

17.3 Git Blame

:git blame

• ガター（行番号エリア）にコミットハッシュ・著者名・日付を表示
• 元ファイルの filetype に基づくシンタックスハイライトが適用される
• blame バッファ内のキー:
  • p — 親コミットの blame へ遷移
  • P — 前の blame に戻る
  • c — カーソル行のコミット詳細（git show）を表示

17.4 Git Status

:git status

git status の結果を読み取り専用バッファで表示します。

17.5 Git Diff

:git diff
:git diff --cached

diff 結果を表示します（filetype: diff でハイライト）。Enter で差分行の対応ファイルにジャンプできます。

17.6 Git Log

:git log
:git log -p          パッチ付き（diff ハイライト）
:git log --oneline

ストリーミングで逐次表示されます。バッファを閉じるとプロセスも停止します。-p 指定時は diff のシンタックスハイライトが適用されます。

17.7 Git Branch

:git branch

ブランチ一覧を表示（コミット日時の新しい順）。各行にブランチ名・日付・最新コミットのサブジェクトを表示。

Enter で :git checkout <branch> がコマンドラインにプリフィルされます（即時実行ではなく確認ステップ付き）。

17.8 Git Commit

:git commit

コミットメッセージ編集バッファが開きます。# で始まる行はコメント（git status 情報）。Insert mode で開始。:w または :wq でコミット実行、:q! でキャンセル。

17.9 Git Grep

:git grep pattern
:git grep -i pattern

git grep -n を実行し、結果バッファで Enter を押すと該当ファイルの該当行にジャンプします。

17.10 その他の Git コマンド

未知のサブコマンドはシェルで直接実行されます。

:git stash
:git rebase -i HEAD~3

Tab 補完で git サブコマンドを補完できます。

18. GitHub 連携

“Alone we can do so little; together we can do so much.” — Helen Keller

18.1 この章で学ぶこと

• :gh link / :gh browse / :gh pr

コードレビューで「この行を見て」と伝えたいとき、GitHub の URL を手でコピーするのは面倒です。:gh link を使えば、エディタ上の現在行の GitHub URL を一瞬で生成・コピーできます。チーム開発のコミュニケーションがスムーズになります。

18.2 GitHub リンクの生成

:gh link              現在ファイル・行の GitHub URL を生成
:'<,'>gh link         選択範囲の行範囲リンクを生成（#L5-L10 形式）
:gh link origin       リモート名を明示指定

URL は message line に表示され、OSC 52 でクリップボードにコピーされます。

18.3 ブラウザで開く

:gh browse            現在ファイルの GitHub ページをブラウザで開く

:gh link と同じ URL 解決ロジックを使用します。

18.4 PR ページを開く

:gh pr                現在ブランチの PR ページをブラウザで開く

18.5 その他の gh コマンド

未知のサブコマンドはシェルで直接実行されます。

:gh issue list
:gh pr status

Tab 補完で gh サブコマンドを補完できます。

第IV部: カスタマイズと拡張

RuVim は Ruby で書かれたエディタです。その最大の強みは、Ruby の力でどこまでも拡張できることにあります。

オプション設定、init.rb による永続化、Plugin API を使った独自コマンドの定義、26 言語のシンタックスハイライト、Rich View モード、ストリーム連携 — 自分の手に馴染むエディタ環境を、Ruby のコードで作り上げましょう。

19. オプション設定

“Give me six hours to chop down a tree and I will spend the first four sharpening the axe.” — Abraham Lincoln

19.1 この章で学ぶこと

• :set の構文
• 主要オプションの解説

道具は自分の手に合うように調整してこそ真価を発揮します。RuVim のオプション設定を使いこなせば、行番号の表示、インデント幅、検索の挙動など、自分の作業スタイルに合ったエディタ環境を構築できます。一度設定すれば init.rb に書いて永続化できるので、繰り返し手動で設定する必要もありません。

19.2 :set の構文

:set                     現在の設定一覧を表示
:set {name}              boolean オプションを ON
:set no{name}            boolean オプションを OFF
:set inv{name}           boolean オプションを反転
:set {name}?             値を表示
:set {name}={value}      値を設定
:setlocal {name}={value} ローカルスコープで設定
:setglobal {name}={value} グローバルスコープで設定

19.3 表示系オプション（Window-local）

19.4 編集系オプション（Buffer-local）

19.5 検索系オプション（Global）

19.6 ウィンドウ/バッファ管理（Global）

19.7 入力・補完系（Global）

19.8 Undo / Grep 系（Global）

19.9 sixel（Global）

20. 設定ファイル

“We shape our tools, and thereafter our tools shape us.” — Marshall McLuhan

20.1 この章で学ぶこと

• init.rb の場所と書き方
• ftplugin の仕組み
• ConfigDSL
• CLI オプションとの組み合わせ

設定ファイルは「あなた専用のエディタ」を作るための設計図です。一度 init.rb を書いておけば、どのマシンでも同じ環境を再現できます。キーバインドの追加やオプションの永続化はもちろん、Ruby の力を借りて独自のコマンドを定義することもできます。

20.2 設定ファイルの場所

$XDG_CONFIG_HOME/ruvim/init.rb
~/.config/ruvim/init.rb          （XDG_CONFIG_HOME 未設定時）

ftplugin（ファイルタイプごとの設定）:

~/.config/ruvim/ftplugin/<filetype>.rb

20.3 init.rb の例

# ~/.config/ruvim/init.rb

# オプション設定
set "number"
set "relativenumber"
set "ignorecase"
set "smartcase"
set "scrolloff=5"
set "splitbelow"
set "splitright"

# キーバインド
nmap "H", "cursor.line_start"
nmap "L", "cursor.line_end"

# カスタムコマンド
command "user.show_path", desc: "Show current file path" do |ctx, **|
  ctx.editor.echo(ctx.buffer.path || "[No Name]")
end

nmap "gp", "user.show_path"

# Ex コマンドとして公開
ex_command_call "ShowPath", "user.show_path"

20.4 ftplugin の例

# ~/.config/ruvim/ftplugin/ruby.rb

setlocal "tabstop=2"
setlocal "expandtab"
setlocal "shiftwidth=2"

# Ruby ファイルでだけ有効なキーバインド
nmap "K", desc: "Show method name" do |ctx, **|
  line = ctx.buffer.line_at(ctx.window.cursor_y)
  if line =~ /def (\w+)/
    ctx.editor.echo("Method: #{$1}")
  end
end

20.5 ConfigDSL メソッド一覧

20.6 CLI オプションとの組み合わせ

ruvim --clean file.txt                 # 設定を読まない
ruvim -u /path/to/custom_init.rb       # 別の設定ファイル
ruvim -u NONE                          # user config を読まない（ftplugin は有効）
ruvim --cmd 'set number' file.txt      # config 読み込み前に実行
ruvim -c 'set number' file.txt         # 起動後に実行

21. Plugin API

“Any sufficiently advanced technology is indistinguishable from magic.” — Arthur C. Clarke

21.1 この章で学ぶこと

• command / ex_command の定義
• nmap / imap の定義
• ctx API の使い方
• :ruby による対話的な Ruby 実行

RuVim の真骨頂は Ruby で書かれたエディタであるという点です。Plugin API を使えば、エディタの内部状態に直接アクセスして、自分だけのコマンドやキーバインドを定義できます。Vim script を覚える必要はありません — Ruby の知識がそのまま活かせます。

21.2 内部コマンドの定義

command "user.hello", desc: "Say hello" do |ctx, argv:, kwargs:, bang:, count:|
  ctx.editor.echo("Hello\! count=#{count}")
end

21.3 Ex コマンドの定義

ex_command "BufInfo", desc: "Show buffer info", nargs: 0 do |ctx, argv:, kwargs:, bang:, count:|
  buf = ctx.buffer
  ctx.editor.echo("#{buf.display_name} (#{buf.line_count} lines, modified=#{buf.modified?})")
end

21.4 Ex → 内部コマンドの中継

command "user.hello" do |ctx, **|
  ctx.editor.echo("hello")
end

ex_command_call "Hello", "user.hello", desc: "Run hello"

これで H キーでも :Hello でも同じ処理を呼べます。

21.5 キーバインドのブロック版

nmap "K", desc: "Show buffer name" do |ctx, **|
  ctx.editor.echo(ctx.buffer.display_name)
end

21.6 ctx API

ブロックに渡される ctx は RuVim::Context です。

主なアクセス先:

ctx.editor          # エディタ全体の状態
ctx.buffer          # 現在バッファ（RuVim::Buffer）
ctx.window          # 現在ウィンドウ（RuVim::Window）

21.7 ctx.editor の主要メソッド

# 表示
ctx.editor.echo("message")
ctx.editor.echo_error("error message")

# モード操作
ctx.editor.enter_normal_mode
ctx.editor.enter_insert_mode

# バッファ操作
ctx.editor.open_path("file.txt")
ctx.editor.switch_to_buffer(buffer_id)
ctx.editor.buffers  # {id => Buffer}

# オプション
ctx.editor.effective_option("tabstop")
ctx.editor.set_option("number", true)

# レジスタ
ctx.editor.get_register("a")
ctx.editor.set_register("a", text: "hello", type: :charwise)

# マーク / ジャンプ
ctx.editor.set_mark("a")
ctx.editor.jump_to_mark("a")

21.8 ctx.buffer の主要メソッド

ctx.buffer.path           # ファイルパス
ctx.buffer.display_name   # 表示名
ctx.buffer.lines          # 行配列
ctx.buffer.line_count     # 行数
ctx.buffer.modified?      # 変更あり?
ctx.buffer.line_at(row)   # 指定行の内容

# 編集（undo グループで囲む）
ctx.buffer.begin_change_group     # 必ず対で呼ぶこと
ctx.buffer.insert_text(row, col, "text")
ctx.buffer.end_change_group

21.9 ctx.window の主要メソッド

ctx.window.cursor_x       # カーソル列
ctx.window.cursor_y       # カーソル行
ctx.window.cursor_y += 10
ctx.window.clamp_to_buffer(ctx.buffer)

21.10 :ruby — 対話的な Ruby 実行

:ruby buffer.line_count
:rb [window.cursor_y, window.cursor_x]
:ruby editor.echo("hello from :ruby")

ctx, editor, buffer, window を参照できます。stdout/stderr の出力は [Ruby Output] バッファに表示されます。

実践例 — バッファ内の行をソート:

:ruby lines = buffer.lines.sort; lines.each_with_index { |l, i| buffer.replace_line(i, l) }

21.11 ファイル分割

# ~/.config/ruvim/init.rb
require File.expand_path("plugins/my_tools", __dir__)

~/.config/ruvim/plugins/my_tools.rb に分離できます。

22. シンタックスハイライトと言語サポート

“Color is a power which directly influences the soul.” — Wassily Kandinsky

22.1 この章で学ぶこと

• 対応言語の一覧
• filetype 検出の仕組み
• オートインデント
• on_save フック

シンタックスハイライトは「目が先にコードの構造を把握する」ための仕組みです。キーワード、文字列、コメントが色分けされていると、コードの意図を読み取る速度が格段に上がります。RuVim は 26 言語に対応し、言語ごとの自動インデントや保存時チェックも備えています。

22.2 対応言語（26言語）

RuVim は以下の言語のシンタックスハイライトに対応しています:

加えて TSV, CSV, 画像ファイル（PNG/JPG/GIF/BMP/WEBP）は Rich View 用の filetype として検出されます。

言語モジュールの継承関係:

C++ は C のハイライトルールを継承し、TypeScript は JavaScript を継承しています。

22.3 filetype 検出

ファイルを開くと、以下の順で filetype を検出します:

手動で filetype を変更:

:set filetype=python

22.4 オートインデント

autoindent がデフォルトで有効です。改行時に前行のインデントを引き継ぎます。

smartindent も有効で、前行が {, [, ( で終わる場合に shiftwidth 分のインデントを追加します。

Ruby filetype では = オペレータでネスト構造に基づく自動インデントが適用されます。

22.5 on_save フック

ファイル保存時に lang モジュールの on_save フックが呼ばれます。

• Ruby: ruby -wc で構文チェック → エラーを quickfix list に展開
• C: gcc でチェック
• C++: g++ でチェック

:set noonsavehook     保存時フックを無効化
:set onsavehook       有効に戻す

23. Rich View モード

“The purpose of visualization is insight, not pictures.” — Ben Shneiderman

23.1 この章で学ぶこと

• TSV/CSV のテーブル表示
• Markdown のリッチ表示
• JSON/JSONL の整形表示
• 画像表示

データはそのままの形式で読むよりも、適切に整形して表示した方が理解しやすくなります。Rich View モードは、TSV/CSV をテーブルに、Markdown をリッチテキストに、JSON をインデント付きで表示します。データファイルを「見る」だけなら、わざわざ別のツールを起動する必要はありません。

23.2 Rich View の起動

gr          Normal mode でトグル
:rich       Ex コマンドでトグル
:rich tsv   形式を明示指定
:rich csv

Rich mode ではバッファ内容を変更せず、描画パイプラインで整形表示します。

23.3 TSV/CSV テーブル表示

TSV/CSV ファイルで Rich View を有効にすると、カラムが整列されたテーブルとして表示されます。

• 区切り表示: `

  `（スペース+パイプ+スペース）

• 列幅は画面に見えている行だけから計算（大規模ファイルでも高速）
• CJK 文字の表示幅を正確に計算

操作例:

（data.tsv を開いた状態で）
gr     ← テーブル表示に切り替え
（移動・検索・yank は通常通り使える）
Esc    ← Normal mode に戻る

表示イメージ:

# 元の TSV データ:
name	age	city
Alice	30	Tokyo
Bob	25	Osaka

# Rich View 表示:
name  | age | city
Alice | 30  | Tokyo
Bob   | 25  | Osaka

23.4 Markdown リッチ表示

Markdown ファイルで Rich View を有効にすると:

• 見出し（H1-H6）: レベル別の太字 + 色
• インライン装飾: **太字**, *斜体*, `コード`, [リンク](url), チェックボックス
• コードブロック: フェンスで囲まれた部分を暖色表示
• テーブル: 列幅揃え + box-drawing 罫線（│, ─, ┼）
• 水平線（HR）: ─ 線に置換
• ブロック引用: > 行を cyan 表示
• 画像: sixel 対応ターミナルでは画像を表示

23.5 JSON/JSONL 整形表示

JSON ファイルで Rich View を有効にすると、ミニファイ JSON を整形して読み取り専用バッファに表示します。

JSONL（1行1JSON）ファイルでは、各行を個別にパース・整形し、--- セパレータで区切って表示します。

仮想バッファ方式なので、Esc / Ctrl-C で元のバッファに戻れます。

23.6 画像表示

画像ファイル（PNG/JPG/GIF/BMP/WEBP）を開くと、自動的に Rich View として表示されます。sixel 対応ターミナルでは画像がインライン表示されます。

:e photo.png     画像ファイルを開く

sixel の制御:

:set sixel=auto    自動検出（デフォルト）
:set sixel=on      強制有効
:set sixel=off     無効

23.7 Rich mode での操作

Rich mode 中は:

• 移動・検索・yank 等は通常通り使える
• バッファを変更する操作（insert/delete/change/paste/replace）はブロックされる
• statusline に -- RICH -- と表示

24. ストリーム連携

“Data is not information, information is not knowledge, knowledge is not wisdom.” — Clifford Stoll

24.1 この章で学ぶこと

• stdin パイプ
• :run コマンド
• :follow コマンド
• 非同期ファイルロード

外部コマンドの出力やログファイルの更新をリアルタイムにエディタ内で確認できるのは、RuVim の大きな強みです。ターミナルマルチプレクサを使わなくても、:run でテストを実行しながら結果を確認したり、:follow でログを監視したりできます。データの「流れ」をエディタで捉えましょう。

24.2 stdin パイプ

コマンドの出力を RuVim にパイプできます:

cat file.txt | ruvim
ls -la | ruvim
git log | ruvim

• バッファ名は [stdin]
• Normal mode の Ctrl-c でストリームを停止
• 完了時: [stdin/EOF]、失敗時: [stdin/error]

24.3 :run コマンド

:run command         コマンドを実行し、出力を [Shell Output] バッファに表示
:run ruby %          現在ファイルを Ruby で実行
:run                 直前のコマンドを再実行（または runprg の値）

• PTY 経由でリアルタイム出力
• Ctrl-C で停止
• % は現在のファイル名に展開
• 変更のあるバッファは実行前に自動保存
• statusline に実行状態を表示

ファイルタイプ別のデフォルト runprg:

実践例 — テスト駆動開発ワークフロー:

24.4 :follow コマンド

:follow              follow mode 開始（トグル）
ruvim -f file.log    起動時から follow mode

ファイルへの追記をリアルタイムにバッファへ反映する tail -f 相当の機能です。

• カーソルが最終行（G）にいると末尾を自動追従
• 途中にいるとスクロール位置を維持
• Ctrl-C や再度 :follow で停止
• follow 中はバッファ変更不可
• ファイルの truncate/削除を検知して対応
• Linux では inotify を優先、使えない場合は polling

24.5 非同期ファイルロード

大きなファイル（デフォルト閾値以上）を開くと:

1. 先頭 8MB を先に表示
2. 残りをバックグラウンドでチャンク単位で読み込み
3. statusline に [load] と表示（完了で消える）

:set syncload        同期ロードに切替（非同期を無効化）
:set nosyncload      非同期に戻す

環境変数で閾値を調整:

RUVIM_ASYNC_FILE_THRESHOLD_BYTES=16777216 ruvim huge.log
RUVIM_ASYNC_FILE_PREFIX_BYTES=4194304 ruvim huge.log

25. 補完

“Perfection is achieved, not when there is nothing more to add, but when there is nothing left to take away.” — Antoine de Saint-Exupery

25.1 この章で学ぶこと

• Command-line 補完
• Insert mode 補完
• 履歴

補完機能はタイピング量を減らすだけでなく、「何が使えるのか」を発見する手段でもあります。コマンドライン補完で利用可能な Ex コマンドやオプションを探索し、Insert mode 補完でバッファ内の変数名を素早く入力しましょう。

25.2 Command-line 補完

: の後で Tab を押すと補完が動作します。

補完対象:

• コマンド名: :w → :write, :wq, :wqa など
• パス: :e , :w の後にファイルパスを補完
• バッファ名: :buffer の後にバッファ名を補完
• オプション名: :set の後にオプション名を補完
• Git サブコマンド: :git の後に blame, status などを補完
• gh サブコマンド: :gh の後に link, browse などを補完

補完の挙動は wildmode オプションで制御:

:set wildmode=full       全候補をサイクル（デフォルト）
:set wildmode=longest    最長共通部分まで展開
:set wildmode=list       候補を一覧表示

除外パターン:

:set wildignore=*.o,*.pyc,__pycache__

25.3 Insert mode 補完

Ctrl-n    次の候補（buffer words 補完）
Ctrl-p    前の候補（buffer words 補完）

バッファ内の単語から補完候補を生成します。

補完 UI の制御:

:set completeopt=menu,menuone,noselect
:set pumheight=15        候補の最大表示件数

25.4 コマンドライン履歴

Up      前の履歴を呼び出す
Down    次の履歴を呼び出す

履歴は prefix ごとに独立して保持されます（:, /, ?）。

26. セキュリティと起動オプション

“Security is not a product, but a process.” — Bruce Schneier

26.1 この章で学ぶこと

• -Z（restricted mode）
• -R（readonly）
• -M（modifiable off）
• DoS 保護
• Unicode 幅の設定

信頼できないファイルを開くことがある以上、セキュリティへの配慮は欠かせません。Restricted mode を使えば、シェル実行や Ruby eval を無効にした安全な閲覧環境を作れます。また、readonly モードは「うっかり変更してしまった」事故を防ぎます。

26.2 Restricted mode (-Z)

ruvim -Z file.txt

以下のコマンドが無効化されます:

• :\!（シェル実行）
• :ruby / :rb（Ruby eval）
• :grep / :lgrep（外部 grep）
• :git（Git 操作全般）
• :gh（GitHub 操作全般）
• user config / ftplugin の読み込み
• Ruby 構文チェック（on_save）

26.3 Readonly mode (-R)

ruvim -R file.txt

バッファが readonly になり、:w が拒否されます。

26.4 Modifiable off (-M)

ruvim -M file.txt

バッファが modifiable=false + readonly=true になり、編集操作が拒否されます。

26.5 DoS 保護

RuVim には以下のセキュリティ対策が含まれています:

• Sixel DoS 保護: PNG デコーダで画像サイズ上限（50M ピクセル）、Zlib 展開サイズ上限（200MB）、URL ダウンロードサイズ上限（10MB）を設定
• 特殊ファイルの拒否: FIFO・デバイス・ソケット等の特殊ファイルは File.file? チェックで拒否
• 制御文字のサニタイズ: Rich view レンダリング時にバッファ内容の制御文字（ESC 含む）を無害化し、ターミナルエスケープインジェクションを防止
• :grep のシェルインジェクション対策: argv 配列で安全に実行（シェル経由ではない）

26.6 Unicode 幅の設定

RUVIM_AMBIGUOUS_WIDTH=2 ruvim      # 曖昧幅文字を幅2として扱う

CJK 環境でギリシャ文字等の幅がずれる場合に設定してください。

A. キーバインド全一覧

A.1 Normal mode

A.2 Insert mode

A.3 Visual mode

A.4 Rich mode

A.5 Command-line mode

B. Exコマンド全一覧

C. オプション全一覧（51個）

C.1 Window-local

C.2 Global

C.3 Buffer-local

D. 対応言語一覧（26言語）

追加の filetype（Rich View 用）:

E. Vimとの違い

E.1 RuVim の独自機能

• Ruby DSL 設定: init.rb で Ruby の全機能を利用可能（Vim script 不要）
• :ruby コマンド: 実行中に Ruby eval が可能
• Rich View モード: TSV/CSV/Markdown/JSON/画像の構造化表示
• Follow mode: :follow / -f でファイル追従（tail -f 相当）
• ストリーム連携: stdin パイプ、:run でリアルタイム出力表示
• 検索は Ruby 正規表現: Vim regex ではなく Ruby の Regexp を使用
• ネスト分割: ツリー構造のウィンドウレイアウト
• Shift+矢印キー: スマート分割（1ウィンドウなら分割、2つ以上ならフォーカス移動）

E.2 動作の差分

• undo 粒度は簡略化（Insert mode は入ってから出るまでが 1 undo 単位）
• . repeat のカウント互換は完全ではない
• word motion の単語境界定義が Vim と一致しない場合がある
• 文字幅は近似（East Asian Width 完全互換ではない）
• :w\! は現状 :w とほぼ同じ（権限昇格は未実装）
• Visual blockwise は最小対応
• option 名の短縮（nu, ts 等）は未対応
• :set の +=, -= は未対応

E.3 未実装の主要機能

• Vim script 互換
• folds
• LSP / diagnostics
• job / channel / terminal
• swap / backup（undofile は実装済み）
• diff mode, session（placeholder のみ）

F. トラブルシューティング

F.1 表示が崩れる

• ターミナルリサイズ後は自動で再描画される
• CJK 文字の幅がずれる場合: RUVIM_AMBIGUOUS_WIDTH=2 ruvim を試す

F.2 日本語の表示幅がおかしい

RUVIM_AMBIGUOUS_WIDTH=2 ruvim

F.3 クリップボードが使えない

RuVim はシステムクリップボードとして以下を試みます:

• macOS: pbcopy / pbpaste
• Linux (Wayland): wl-copy / wl-paste
• Linux (X11): xclip or xsel
• WSL: PowerShell 経由

対応コマンドがインストールされているか確認してください。

F.4 大きいファイルの読み込みが遅い

# 同期ロードに切替
ruvim --sync-load huge.log

# 閾値を調整
RUVIM_ASYNC_FILE_THRESHOLD_BYTES=33554432 ruvim huge.log

F.5 設定ファイルが読み込まれない

• パスを確認: ~/.config/ruvim/init.rb
• --clean を付けて起動すると設定なしで起動
• -V で verbose ログを確認

ruvim -V file.txt 2>log.txt
cat log.txt

F.6 on_save の構文チェックを止めたい

:set noonsavehook

init.rb に書く場合:

set "noonsavehook"

F.7 デバッグ情報を見る

ruvim -V2 file.txt 2>debug.log
ruvim --startuptime timing.log file.txt

G. おすすめ初期設定

RuVim を初めて使う方向けのおすすめ init.rb です。以下を ~/.config/ruvim/init.rb に保存してください。各オプションの詳細はオプション設定と設定ファイルを参照してください。

# ~/.config/ruvim/init.rb
# RuVim 初心者向けおすすめ設定

# ═══════════════════════════════════════════
# 表示設定
# ═══════════════════════════════════════════

# 行番号を表示する（コードの位置を把握しやすくなる）
set "number"

# 相対行番号を表示する（5j, 10k のようなカウント移動が楽になる）
set "relativenumber"

# 現在行をハイライトする（カーソル位置を見失いにくくなる）
set "cursorline"

# カーソルの上下に常に5行の余白を確保する（先読みしやすくなる）
set "scrolloff=5"

# 80桁目にガイド線を表示する（行が長くなりすぎるのを防ぐ）
set "colorcolumn=80"

# ═══════════════════════════════════════════
# 検索設定
# ═══════════════════════════════════════════

# 検索時に大文字小文字を無視する
set "ignorecase"

# ただし、大文字を含む検索パターンでは大文字小文字を区別する
# （"foo" → case-insensitive, "Foo" → case-sensitive）
set "smartcase"

# 検索パターン入力中にリアルタイムでマッチを表示する
set "incsearch"

# ═══════════════════════════════════════════
# ウィンドウ分割の方向
# ═══════════════════════════════════════════

# :split 時に新しいウィンドウを下に配置する（直感的な方向）
set "splitbelow"

# :vsplit 時に新しいウィンドウを右に配置する（直感的な方向）
set "splitright"

# ═══════════════════════════════════════════
# 編集設定
# ═══════════════════════════════════════════

# Tab キーでスペースを挿入する（多くのプロジェクトのコーディング規約に合致）
set "expandtab"

# インデント幅を2に設定する（Ruby の標準的なスタイル）
set "shiftwidth=2"

# タブの表示幅を2に設定する
set "tabstop=2"

# 未保存バッファがあっても別バッファへ切り替えられるようにする
set "hidden"

# ═══════════════════════════════════════════
# 補完設定
# ═══════════════════════════════════════════

# 補完候補から除外するファイルパターン
set "wildignore=*.o,*.pyc,*.class,__pycache__,.git"

# ═══════════════════════════════════════════
# キーバインド（お好みで）
# ═══════════════════════════════════════════

# H で行頭、L で行末に移動する（0/$ より押しやすい）
# nmap "H", "cursor.line_start"
# nmap "L", "cursor.line_end"

# ═══════════════════════════════════════════
# ファイルタイプごとの設定例
# ═══════════════════════════════════════════
# Python ファイルではインデント幅を4にしたい場合:
#   ~/.config/ruvim/ftplugin/python.rb に以下を記述:
#
#   setlocal "shiftwidth=4"
#   setlocal "tabstop=4"
#   setlocal "expandtab"

この設定をベースに、自分の好みに合わせてカスタマイズしていきましょう。不要な設定は行頭に # を付けてコメントアウトできます。

本書は RuVim の現在の実装に基づいています。将来のバージョンで機能が追加・変更される場合があります。