← Vim研究所

Vimでシェルコマンドの出力をバッファに直接挿入する（:r!）

2019-05-30 公開 ・ 更新: 2026-08-05

ターミナルでlsを実行して、その結果をコピーしてVimに貼り付ける、という作業を繰り返していました。コマンドの実行結果を直接バッファに挿入するコマンドがあり、コピペの手間そのものがいらなくなります。

目次（7項目）
キーこれだけ覚える
:r!{コマンド}コマンドの出力をバッファに挿入
:!{コマンド}結果を画面に表示するだけ（バッファには残らない）
:new新規バッファを開いてから読み込む

コマンドの実行結果を挿入する

:r!{コマンド}

:r（:read）はファイルの内容をバッファに読み込むコマンドですが、続けて!とコマンドを書くと、ファイルの代わりにコマンドの実行結果をそのまま挿入してくれます。カーソル行の下に結果が挿入されます。

BEFORE 
line 1
line 2
:r!echo hi
AFTER 
line 1
hi
line 2

よく使う場面

:r!ls        " カレントディレクトリのファイル一覧を挿入（Linux/Mac）
:r!dir       " 同上（Windows）
:r!pwd       " カレントディレクトリのフルパスを挿入

設定ファイルにファイル一覧を書き出したいときや、スクリプトの中に現在のパスをハードコードしたいときなど、「今いる場所の情報をそのままテキストとして取り込みたい」場面で特に役立ちます。dateコマンドで現在時刻を挿入したり、git log --oneline -5で直近のコミット一覧を挿入したりと、応用範囲は広いです。

カーソル位置に注意する

挿入先はカーソルのある行の下です。意図しない場所に挿入してしまわないよう、実行前にカーソル位置を確認しておくと安心です。挿入した直後の内容が気に入らなければ、通常どおりuでアンドゥできるので、試しに実行してから調整する使い方でも問題ありません。

:!との違い

:!{コマンド}は結果を画面に表示するだけで、バッファには何も残りません。一方:r!{コマンド}はその結果をテキストとしてバッファに書き込みます。「見るだけでいいのか、テキストとして残したいのか」で使い分けると便利です。コマンド実行全般の使い分けは別記事にまとめています。

要点：コマンドの結果をその場で見るだけなら:!、テキストとしてバッファに取り込みたいなら:r!。コピペの手間を1コマンドで省けます。
使ってみて

ディレクトリ構成をREADMEに書き出す作業で、毎回lsの結果を手でコピペしていましたが、:r!lsを知ってからはその手間がまるごと消えました。地味なコマンドですが、ドキュメント作成やスクリプトの雛形作りをする機会が多い人ほど積み重なる時短効果は大きいと感じています。挿入位置を間違えてもuで戻せると分かってからは、気軽に試せるようになりました。

新規バッファに読み込みたい場合

今編集中の内容とは別に、コマンドの結果だけをまっさらなバッファで見たいときは、先に:newで新しいバッファを開いてから:r!を実行すると安心です。既存の内容を汚さずに済むので、探索的にコマンドの出力を確認したいときや、結果を見ながら必要な部分だけ元のファイルにコピーしたいときに向いています。

:new
:r!git log --oneline -10

まとめ

:r!はシェルコマンドの出力をそのままテキストとしてバッファに取り込めます。コピペの手間を減らしたいなら覚えておいて損はないコマンドです。

関連記事

← Vim研究所 トップへ戻る