Vimのソースを表示

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[de:Vim]]
[[en:Vim]]
[[es:Vim]]
[[pt:Vim]]
[[ru:Vim]]
[[zh-hans:Vim]]
{{Related articles start}}
{{Related|アプリケーション一覧/ドキュメント#Vi テキストエディタ}}
{{Related articles end}}
[[Wikipedia:ja:Vim|Vim]] は、ターミナルテキストエディタです。[[vi]] の拡張版で、シンタックスハイライト、包括的なヘルプシステム、ネイティブスクリプト (Vim script)、テキスト選択のためのビジュアルモード、ファイルの比較 ({{man|1|vimdiff|pkg=vim}}) といった追加機能、および {{man|1|rview|pkg=vim}} や {{man|1|rvim|pkg=vim}} など制限付きのツールが含まれています。

== インストール ==

以下のどちらかのパッケージをインストールしてください:
* {{Pkg|vim}} パッケージは Python, Lua, Ruby, Perl インタプリタをサポート、GTK/X はサポートされません。
* {{Pkg|gvim}} パッケージは上の {{ic|vim}} パッケージと同じものに加えて GTK/X サポートが付属。

{{note|
* {{Pkg|vim}} パッケージには [[Xorg]] のサポートが組み込まれていません。従って、{{ic|+clipboard}} 機能がないため、Vim は X11 のプライマリ・クリップボードの[[クリップボード|セレクションバッファ]]を利用することができません。{{Pkg|gvim}} パッケージには {{ic|+clipboard}} が有効になっている完全な X サポートが入った Vim の CLI バージョンも含まれています。
* 非公式の [[非公式ユーザーリポジトリ#herecura|herecura]] リポジトリには様々な種類の Vim / gVim が取り揃えられています: {{ic|vim-cli}}, {{ic|vim-gvim-common}}, {{ic|vim-gvim-gtk}}, {{ic|vim-gvim-qt}}, {{ic|vim-rt}}, {{ic|vim-tiny}}}}

==使用方法==

これは Vim の使用方法に関する基本的な概略です。また、{{Ic|vimtutor}} もしくは {{Ic|gvimtutor}} を実行すると25-30分ほどの vim のチュートリアルが起動します。

Vim には4つのモードが備わっています:

* コマンドモード: キー入力はコマンドとして解釈されます。
* 挿入モード: キー入力はファイルに挿入されます。
* ビジュアルモード: キー入力でテキストを選択・カット・コピーします。
* Ex モード: 追加的なコマンドのための入力モード (例: ファイルの保存, テキストの置換...)

===編集の基本===

次のように Vim を起動すると:

 $ vim somefile.txt

空のドキュメントが表示されます (somefile.txt が存在しない場合。存在するときは、その中身が表示されます) このまま編集することはできません – 今いるのはコマンドモードです。このモードではキーボードを使って Vim にコマンドを実行させることができます。

{{Note|Vim は典型的な古典的 Unix スタイルのソフトウェアです。学習曲線は急峻ですが、一度初めてしまえば、Vim がとても強力なのがわかるでしょう。また、全てのコマンドは大文字・小文字を区別します。場合によって大文字のコマンドはその元のコマンドを「大雑把にした」コマンドだったり ({{ic|s}} は文字を置き換え、{{ic|S}} は行を置き換えます)、または全く違うコマンドだったりします ({{ic|j}} は下に移動しますが、{{ic|J}} は2行を結合します)}}

{{ic|i}} コマンドで (カーソルの前に) テキストを挿入します。{{ic|I}} (大文字の '''i''') は行の最初にテキストを挿入します。テキストの追記 (カーソルの後ろにテキストを記述、ほとんどの人が予期するであろう挿入) には {{ic|a}} を使います。{{ic|A}} を入力するとカーソルが行末に置かれます。

{{ic|Esc}} を押すことでいつでもコマンドモードに戻ることができます。

===移動===

Vim では、矢印キーを使ってカーソルを移動することができますが、これは '''Vim の流儀'''とは言えません。標準のタイピングポジションから矢印キーまで右手を動かしたり、戻したりすることになります。楽しくありません。

Vim においては {{ic|j}} を押すことで下に移動できます。“j” は垂れ下がっていると覚えて下さい。逆に {{ic|k}} を押すことでカーソルを上に移動できます。左は {{ic|h}} で (“j” の左にあります)、右は {{ic|l}} です (小文字の '''L''')

{{ic|^}} はカーソルを行の最初に、{{ic|$}} は最後に移動します。

{{Note|一般的に {{ic|^}} と {{ic|$}} は正規表現で、行の最初と最後にマッチするものとして使われます。正規表現はかなり強力で *nix 環境では大抵使われています。初めは取っ掛かりにくいように感じられるかもしれませんが、そのうちにほとんどのキーマッピングにはある「思想」が共通していることに気がつくでしょう。}}

次の単語に進むには、{{ic|w}} キーを押します。{{ic|W}} はより多くの文字列を単語として考えます (例えばアンダースコアやダッシュを単語の一部としてみなします) 前の単語に戻るには、{{ic|b}} を使います。同じように、{{ic|B}} は Vim が単語としてみなすものにより多くの文字列を含めます。単語の末尾に移動するには、{{ic|e}} を使い、{{ic|E}} はより多くの文字列を含めて考えます。

文の最初に移動したいときは、{{ic|(}} を使います。{{ic|)}} は反対に、センテンスの最後まで移動します。もっと大きな単位で移動したい場合は、{{ic|{}} で段落の最初まで移動できます。{{ic|<nowiki>}</nowiki>}} はパラグラフ全体の終末まで移動します。

画面の一番上の行に移動するには、{{ic|H}} を使います。{{ic|M}} は画面の真ん中まで移動し、{{ic|L}} は一番下の行に移動します。{{ic|gg}} はファイルの先頭まで飛び、{{ic|G}} はファイルの一番最後まで行きます。{{ic|Ctrl+D}} はページごとにスクロールします。

===コマンドの繰り返し===

コマンドの前に数字を付けると、その回数分コマンドが繰り返し実行されます (ただし {{ic|s}} コマンドなど例外はあります) 例えば、{{ic|3i}} → “Help! ” → {{ic|Esc}} と入力すると “Help! Help! Help!“ と書かれます。{{ic|<nowiki>2}</nowiki>}} なら2段落だけ前に進みます。これは次のコマンドで役に立ちます。

===削除===

{{ic|x}} コマンドはカーソル上の文字を削除します。{{ic|X}} はカーソルの前の文字を消します。先の繰り返しと組み合わせると便利です。{{ic|6x}} は6文字分削除します。{{ic|.}} (ドット) を押すと直前の動作が繰り返されます。例えば、何箇所に "foobar" という単語を書いていたとして、あれやこれやと考えた末、“foo” だけにしたくなったとします。その際は、"b" のところまでカーソルを移動して、{{ic|3x}} と入力して、次の "foobar" に移って {{ic|.}} (ドット) を押せば "bar" を簡単に削除できます。

{{ic|d}} は Vim に何かを削除したいことを伝えます。{{ic|d}} を押した後、Vim に削除したいものを指定してください。移動コマンドを使うことで指定することができます。{{ic|dW}} は次の単語を削除します。{{ic|d^}} は行の先頭まで削除を行います。削除コマンドの前に数字を付けることもできます: {{ic|3dW}} は次の3つの単語を削除します。{{ic|D}} (大文字) は行末まで削除するショートカットです (つまり {{ic|d$}}) {{ic|dd}} と入力すると一行まるまる削除されます。

単語を削除して置き換えたいときは、単語の上にカーソルを移動して {{ic|cw}} コマンドを実行してください。単語を削除してから挿入モードに移行します。一文字だけ置換するときは {{ic|r}} を使います。

===アンドゥとリドゥ===

Vim にはクリップボードが内蔵されています (バッファとも呼ばれます) 操作は {{ic|u}} で元に戻し {{ic|Ctrl+r}} でやり直すことができます。

===ビジュアルモード===

{{ic|v}} を押すことでビジュアルモードに入ることができます。ビジュアルモードではあちこち移動して文章を選択し、選択したら、{{ic|y}} を押して文章をバッファにヤンク (コピー) したり、{{ic|c}} でカットすることが可能です。カーソルの後ろには {{ic|p}} でペーストし、{{ic|P}} はカーソルの前にペーストします。{{ic|V}} は行単位で選択するビジュアルラインモードです。{{ic|Ctrl+v}} は矩形選択を行います。

{{Note|何かを削除した時はいつでも、その何かはバッファの中に保存され、貼り付けることが可能です。}}

===検索と置換===

ファイル内の単語または文字を検索するには、{{ic|/}} を使って検索したい文字列を入力してエンターを押します。次の検索結果を見るには {{ic|n}} を、前の結果に戻るには {{ic|N}} を押して下さい。

検索と置換をしたいときは代わりに {{ic|:s/}} コマンドを使います。構文は: {{Ic|[range]s///[arguments]}}。例:

{{bc|
Command         Outcome
:s/xxx/yyy/     Replace xxx with yyy at the first occurrence
:s/xxx/yyy/g    Replace xxx with yyy at every occurrence in the current line
:s/xxx/yyy/gc   Replace xxx with yyy global with confirm
:%s/xxx/yyy/g   Replace xxx with yyy global in the whole file
:#,#s/xxx/yyy/g Replace xxx with yyy line number range
}}

グローバル {{ic|:g/}} コマンドを使えばパターン検索をしてマッチした部分でコマンドを実行することができます。構文は: {{Ic|[range]:g//[cmd]}}。

{{bc|
Command  Outcome
:g/^#/d  Delete all lines that begins with #
:g/^$/d  Delete all lines that are empty
}}

===保存と終了===

保存や終了したいときは、Ex モードを使う必要があります。Ex モードのコマンドには {{ic|:}} を前に付けます。ファイルを保存するには {{ic|:w}} を使い、名前を付けてファイルを保存するには {{ic|''':w''' filename}} を使います。終了は {{ic|:q}} です。変更を保存しないときには {{ic|:q!}} を使って下さい。保存して終了は {{ic|:x}} です。

=== その他のコマンド ===

# {{ic|s}} を押すとカーソルの文字が消され、挿入モードに変わります。{{ic|S}} は行全体を消去して、挿入モードに移行します。
# {{ic|o}} は行の下に新しい行を追加して挿入モードに変わります、{{ic|O}} 行の上に新しい行を追加して挿入モードに移行します。
# {{ic|yy}} は行全体をヤンクします。
# {{ic|cc}} はカーソルがある行を削除して挿入モードに入ります。
# {{ic|*}} は単語をハイライトして、{{ic|n}} はその単語を検索します。

==設定==

Vim のユーザー別の設定ファイルはホームディレクトリに配置されます: {{ic|~/.vimrc}}。カレントユーザーの Vim ファイルは {{ic|~/.vim/}} の中に配置されます。グローバルな設定ファイルは {{ic|/etc/vimrc}} にあります。グローバルな Vim ファイルは {{ic|/usr/share/vim/}} の中にあります。

gVim の場合、ユーザー固有の設定ファイルは {{ic|~/.gvimrc}} にあり、グローバル設定ファイルは {{ic|/etc/gvimrc}} にあります。

{{Note|
* シンタックスハイライトなどの一般的な機能は {{ic|defaults.vim}} で有効になっており、{{ic|~/.vimrc}} が存在しない場合にロードされます。{{ic|1=let skip_defaults_vim=1}} を {{ic|/etc/vimrc}} に追加することで {{ic|defaults.vim}} のロードを完全に無効化できます [https://github.com/vim/vim/issues/1033]
* gVim は Vim と gVim の設定ファイルの両方をロードしますが、Vim は Vim の設定ファイルのみをロードします。
}}

 set wrapscan

=== クリップボード ===

{{ic|:yank}} や {{ic|:paste}} などの Vim コマンドは名前のないレジスタを使用しますが、デフォルトでは {{ic|"*}} レジスタがこれにあたります。{{ic|+clipboard}} 機能が有効になっている場合、{{ic|"*}} レジスタは X の {{ic|PRIMARY}} バッファになります。

デフォルトのレジスタを変更するには {{ic|1=:set clipboard=unnamedplus}} で {{ic|"+}} レジスタを使うことができます。{{ic|"+}} レジスタは X の {{ic|CLIPBOARD}} バッファに相当します。
{{ic|clipboard}} オプションはカンマ区切りの値に設定できることに注意してください。{{ic|1=:set Clipboard=unnamedplus,unnamed}} の場合、ヤンク操作では、ヤンクされたテキストが {{ic|"+}} レジスタに加えて {{ic|"*}} レジスタにもコピーされます。(ただし、削除、変更、および配置の操作は、依然として {{ic|"+}} レジスタに対してのみ実行されます)

詳細については、{{ic|:help 'clipboard'}}を参照してください。{{ic|clipboard}} 機能に設定できる値は他にもあります。{{ic|:help Clipboard-unnamed}} を使用すると、この機能に設定できる最初の有効な値のヘルプ トピックに移動し、続いて他のすべての有効な値のヘルプに移動できます。

{{Tip|
* コピー&ペースト操作のためのカスタムショートカットを作成できます。{{ic|Ctrl+c}}、{{ic|Ctrl+v}}、および {{ic|Ctrl+x}} のバインディングについては、[https://superuser.com/a/189198] を参照してください。
* X クリップボードは vim が終了するとフラッシュされます。vim の選択を X クリップボード内で永続的にするには、[[クリップボードマネージャ]] が必要です。あるいは、 {{ic|autocmd VimLeave * call system("echo -n $'" . escape(getreg(), "'") . "' {{!}} xsel --input --clipboard")}} を {{ic|.vimrc}} に追加します。({{Pkg|xsel}} パッケージが必要です)
}}

===シンタックスハイライト===

シンタックスハイライトを有効にするには (Vim は膨大な数のプログラミング言語をサポートしています):

 :filetype plugin on
 :syntax on

=== インデント ===

特定のファイルタイプのインデントファイルをロードするには:

 :filetype indent on

=== 折返し表示 ===

{{ic|wrap}} オプションはデフォルトでオンになっており、ウィンドウの幅より長い行を折り返し、残りの行を次の行に表示するように Vim に指示します。{{ic|wrap}} オプションはテキストの表示方法のみに影響し、テキスト自体は変更されません。

折り返しは通常、単語の途中であっても、ウィンドウに収まる最後の文字の後に行われます。よりインテリジェントな折り返しは {{ic|linebreak}} オプションで制御できます。{{ic|set linebreak}} で有効にすると、{{ic|breakat}} 文字列オプションにリストされた文字の後に折り返しが発生します。

折り返された行は通常、インデントに関係なく次の行の先頭に表示されます。[https://retracile.net/wiki/VimBreakIndent breakindent] オプションは、長い行を折り返すときにインデントを考慮し、折り返された行が前に表示されていた行と同じインデントを保つように Vim に指示します。{{ic|breakindent}} の動作は {{ic|breakindentopt}} オプションで微調整することができ、例えば Python ファイルでは折り返す行をさらに 4 スペース右にずらすことができます (詳細は{{ic|:help breakindentopt}} を参照してください):

 autocmd FileType python set breakindentopt=shift:4

===マウスを使う===

Vim にはマウスを利用できるようにする機能がありますが、特定のターミナルでしか機能しません (Linux なら [[xterm]] と {{Pkg|gpm}} による Linux コンソール、あるいは [[PuTTY]]、詳しくは[[コンソールマウスサポート]] を参照)

この機能を有効にするには次の行を {{ic|~/.vimrc}} に追加してください:
 set mouse=a

{{ic|~/.vimrc}} が存在しない場合 {{ic|1=mouse=a}} オプションを {{ic|defaults.vim}} に設定することで読み込まれます。

{{Note|ターミナルでマウスを有効にすると、X サーバーにアクセスできる場合、コピー&ペーストは {{ic|"*}} レジスタを使うようになります。Shift キーを押すことで xterm によるマウスボタンの処理を利用できます。{{ic|clipboard}} オプションも参照してください。}}

===矢印キーによる行移動===

デフォルトでは、行頭で {{ic|←}} を押したり、行末で {{ic|→}} を押しても、カーソルは前の行や次の行に移動しません。

{{ic|~/.vimrc}} ファイルに {{ic|1=set whichwrap=b,s,<,>,[,]}} を追加することでこのデフォルトの挙動を変更することができます。

== ファイルのマージ ==

Vim には差分エディタが入っています。2つ (もしくはそれ以上) のファイルの差分をマージするのを助けるプログラムです。{{ic|vimdiff}} は横にマルチペイン表示を行って差分を色でハイライトします、それぞれのペインには確認・編集するファイルが開かれます。Vim には[[#使用方法|複数のモード]]が存在しますが、重要なのは文章を編集する'''挿入モード'''と、ウィンドウや行をわたってカーソルを移動する'''コマンドモード'''の2つです。{{ic|vimdiff file1 file2}} を実行して起動します。以下はいくつかのコマンドの例です。

{| class="wikitable"
! アクション          !! ショートカット
|-
| 次の差分     || {{ic|]c}}
|-
| 前の差分 || {{ic|[c}}
|-
| カーソルが (ハイライトされた) 差分の上にあるとき、もうひとつのウィンドウから現在のウィンドウに差分をコピー     || {{ic|do}}
|-
| 現在のウィンドウからもうひとつのウィンドウへ差分をコピー        || {{ic|dp}}
|-
| 折り畳まれた文章を開く       || {{ic|zo}}
|-
| 折り畳まれた文章を閉じる      || {{ic|zc}}
|-
| ファイルの差分を再スキャン    || {{ic|:diffupdate}}
|}

== ヒントとテクニック ==

作業を完遂するための特定のユーザーのトリック。

===行番号===

* {{Ic|:set number}} で行番号を表示。
* {{ic|:set relativenumber}} で相対的な行番号を表示。
* {{Ic|:<line number>}} でその行番号にジャンプ。

ジャンプはジャンプリストに記録されます。詳しくは {{ic|:h jump-motions}} を参照。

=== スペルチェック ===

 set spell

この設定を使うと、Vim はスペルが間違っている単語をハイライトします。ミススペルの単語にカーソルを載せて {{ic|1=z=}} を入力すればスペルのサジェストが表示されます。

デフォルトでは英語の辞書しかインストールされていません、他の辞書は[[公式リポジトリ]]からインストールできます。利用可能な言語のリストを表示するには:

 # pacman -Ss vim-spell

言語辞書は [http://ftp.vim.org/vim/runtime/spell/ Vim FTP archive] からも入手できます。ダウンロードした辞書は {{ic|~/.vim/spell}} フォルダに配置して、次を入力して辞書をセットしてください: {{ic|1=:setlocal spell spelllang=LL}}

{{Tip|
* LaTeX (または TeX) 文章のスペルチェックのみを有効にしたいときは、{{ic|1=autocmd FileType tex setlocal spell spelllang=en_us}} を {{ic|~/.vimrc}} や {{ic|/etc/vimrc}} に追加して、Vim を再起動してください。英語以外の言語のスペルチェックを使う場合は、{{ic|en_us}} を適当な言語で置き換えて下さい。
* 2つの言語のスペルチェックを有効にするには (例えば英語とドイツ語)、{{ic|1=set spelllang=en,de}} を {{ic|~/.vimrc}} や {{ic|/etc/vimrc}} に追加して、Vim を再起動してください。
* FileType プラグインとファイルタイプを検出するカスタムルールを使うことで任意のファイルタイプ (例: *.txt) のスペルチェックを有効にすることができます。名前の最後が {{ic|*.txt}} で終わるファイルのスペルチェックを有効にするには、{{ic|/usr/share/vim/vimfiles/ftdetect/plaintext.vim}} ファイルを作成して、{{ic|autocmd BufRead,BufNewFile *.txt    setfiletype plaintext}} という行をファイルの中に記述します。そうしたら、{{ic|1=autocmd FileType plaintext setlocal spell spelllang=en_us}} を {{ic|~/.vimrc}} や {{ic|/etc/vimrc}} に追加して、Vim を再起動してください。もしくは、{{ic|~/.vimrc}} または {{ic|/etc/vimrc}} に {{ic|autocmd BufRead,BufNewFile *.txt setlocal spell}} 行を追加してから Vim を再起動してください。スペルチェックを使用するファイルタイプ ({{ic|*.txt}}) を指定するようにしてください。}}

=== 実行状態の保存 ===

通常、{{ic|vim}} を終了すると、開いているファイル、コマンドラインの履歴、ヤンクしたテキストなど、必要のない情報はすべて破棄されます。この情報を保存するかどうかは、以下の方法で設定できます。

==== viminfo ファイル ====

また、{{ic|viminfo}} ファイルには、コマンドライン履歴、検索文字列履歴、入力行履歴、レジスタの内容、ファイルのマーク、ファイル内の位置マーク、最後の検索/置換パターン (セッション内で {{ic|n}} と {{ic|&}} による検索モードで使用)、バッファリスト、定義済みのあらゆるグローバル変数を保存するために使用されることがあります。{{ic|viminfo}} モダリティを使用するには、インストールした {{ic|vim}} のバージョンが {{ic|+viminfo}} 機能付きでコンパイルされている必要があります。

{{ic|viminfo}} ファイルに何を残すかを設定するには、例えば {{ic|~/.vimrc}} ファイルに以下のように記述します。

 set viminfo='10,<100,:100,%,n~/.vim/.viminfo

各パラメータの前には識別子が付きます:

 'q  : q, 記憶された編集済みファイルの数
 <m  : m, 各レジスタに保存される行数
 :p  : p, 記憶された履歴コマンド行の数
 %   : バッファリストを保存して復元します
 n...: viminfo ファイルへの完全修飾パス (これはリテラル "''n''" であることに注意してください。)

既存の {{ic|viminfo}} ファイルが現在のセッション情報、例えばあなたが終了しようとしている現在のセッションのいくつかのバッファから更新されるときに、どのように変更されるかの詳細については、公式 [https://vimdoc.sourceforge.net/htmldoc/options.html#'viminfo' viminfo documentation] をご覧ください。

==== セッションファイル ====

セッションファイルは、任意の数の特定のセッションの状態を長期にわたって保存するために使用できます。各セッションやプロジェクトに1つの個別のセッションファイルを使用することができます。このモダリティを使用するには、インストールした {{ic|vim}} のバージョンが {{ic|+mksession}} 機能付きでコンパイルされている必要があります。

セッション内で {{ic|:mksession[!] [''my_session_name.vim'']}} はカレントディレクトリの {{ic|''my_session_name.vim''}} に vim-script を書き出します。ファイル名を ''not'' にするとデフォルトで {{ic|Session.vim}} が使われます。オプションの {{ic|!}} は、同じ名前とパスの既存のセッションファイルを破棄します。

{{ic|vim}} セッションは、ターミナルから ''vim'' を起動するときに再開できます:

 $ vim -S [''my_session_name.vim'']

または、vim コマンドを実行して、既に開いているセッション バッファーで次のようにします。

 :source ''my_session_name.vim''

保存される内容やセッションファイルのオプションの詳細については、[https://vimdoc.sourceforge.net/htmldoc/usr_21.html#21.4 vim documentation] で詳しく説明されています。コメント付きの例は、[https://vim.wikia.com/wiki/Go_away_and_come_back ここ] にあります。

==== カーソル位置の保存 ====

こちらを参照 [https://vim.wikia.com/wiki/Restore_cursor_to_file_position_in_previous_editing_session Restore cursor to file position in previous editing session]

===vi コマンドを vim で置き換える===

{{ic|vi}} を {{ic|vim}} にする [[Bash#エイリアス|エイリアス]] を作成してください。

もしくは、{{ic|sudo vi}} と入力したときに {{ic|vim}} が起動するようにしたい場合、{{AUR|vi-vim-symlink}} をインストールしてください。{{ic|vi}} が削除され {{ic|vim}} のシンボリックリンクで置き換えられます。

=== DOS/Windows のキャリッジリターン (CR)===

行末に "^M" が表示されることがあります。これは MS-DOS や Windows で作成したテキストファイルを編集しようとしたときに起こります。

解決方法:
次のコマンドで "^M" を全て置換:

{{bc|:%s/^M//g}}

注意、"^" は制御文字なので、{{ic|Ctrl+Q}} を押して正しい "^" を取得してください。

もしくは、公式リポジトリから {{pkg|dos2unix}} パッケージをインストールして、{{ic|dos2unix <file name here>}} を実行してください。

{{Note|{{ic|fileformat}} の設定を変えるという方法もあります。{{ic|<nowiki>set ff=unix</nowiki>}} で DOS/Windows の改行コードが使われているファイルを Unix の改行コードに変換できます。逆をしたい場合、{{ic|<nowiki>set ff=dos</nowiki>}} で Unix の改行コードが DOS/Windows の改行コードに変換されます。}}

=== gVim ウィンドウの底部の空きスペース ===

ウィンドウサイズのヒントを無視するように設定された[[ウィンドウマネージャ]]を使っている場合、gVim は空の領域を GTK テーマの背景色で塗りつぶします。

解決方法はウィンドウ下部の gVim が確保するスペースを調整することです。ゼロに設定した場合、下の横スクロールバーが見えなくなってしまうことがあるので注意してください。次の行を {{ic|~/.vimrc}} に記述します:

 set guiheadroom=0

=== Vim をページャとして使う ===

スクリプトを使える Vim は [[アプリケーション一覧/ユーティリティ#ターミナルページャ]] として使用することができ、配色などの様々な Vim の機能を得ることができます。

Vim には {{ic|/usr/share/vim/vim91/macros/less.sh}} スクリプトが付属しており、その [[エイリアス]] を作成することで利用できます。このスクリプトは {{man|1|less|OPTIONS}} で述べられているコマンドラインフラグをサポートしていないことに注意してください。

代わりに、{{Pkg|vimpager}} という Vim スクリプトもあります。Vim スクリプトもあります。デフォルトのページャーを変更するには、環境変数 {{ic|PAGER}} を [[export]] してください。全てのコマンドラインフラグに対応しているわけではないことに注意してください。対応するフラグの一覧は、こちらを参照してください。 [https://github.com/rkitover/vimpager#command-line-options available on GitHub]

=== 検索結果の強調表示 ===

検索の入力中に検索で一致する最初の文字列を強調表示するには、{{ic |~/.vimrc}} に次の行を追加します。

 set incsearch

検索の入力中に検索で一致するすべての文字列を強調表示するには、検索が実行された後、{{ic |~/.vimrc}} に次の行を追加します。

 set hlsearch

{{Note|
* {{ic|hlsearch}} を設定すると、さらに検索が行われるまで、すべての一致が強調表示されたままになります。この動作は望ましくない場合があるため、次の検索まで一時的に強調表示を無効にするには、{{ic|:nohlsearch}} を実行します。このコマンドを頻繁に実行する場合は、コマンドをキーにバインドすることを検討してください。
* この動作は、{{ic|s}} や {{ic|g}} などの正規表現を含む他のコマンドで正規表現を照合するときにも表示されます。
}}

=== XDG Base Directory 仕様の回避策 ===

[https://github.com/vim/vim/commit/6a459902592e2a4ba68 7.3.1178] 以降、{{ic|~/.vimrc}} が見つからない場合、vim は {{ic|~/.vim/vimrc}} を検索します。

{{hc|"$XDG_CONFIG_HOME"/vim/vimrc|<nowiki>
set runtimepath^=$XDG_CONFIG_HOME/vim
set runtimepath+=$XDG_DATA_HOME/vim
set runtimepath+=$XDG_CONFIG_HOME/vim/after

set packpath^=$XDG_DATA_HOME/vim,$XDG_CONFIG_HOME/vim
set packpath+=$XDG_CONFIG_HOME/vim/after,$XDG_DATA_HOME/vim/after

let g:netrw_home = $XDG_DATA_HOME."/vim"
call mkdir($XDG_DATA_HOME."/vim/spell", 'p')

set backupdir=$XDG_STATE_HOME/vim/backup | call mkdir(&backupdir, 'p')
set directory=$XDG_STATE_HOME/vim/swap   | call mkdir(&directory, 'p')
set undodir=$XDG_STATE_HOME/vim/undo     | call mkdir(&undodir,   'p')
set viewdir=$XDG_STATE_HOME/vim/view     | call mkdir(&viewdir,   'p')

if !has('nvim') | set viminfofile=$XDG_STATE_HOME/vim/viminfo | endif
</nowiki>}}

{{hc|~/.profile|2=
export GVIMINIT='let $MYGVIMRC="$XDG_CONFIG_HOME/vim/gvimrc" {{!}} source $MYGVIMRC'
export VIMINIT='let $MYVIMRC="$XDG_CONFIG_HOME/vim/vimrc" {{!}} source $MYVIMRC'
}}

{{ic|[G]VIMINIT}} 環境変数は、Neovim にも影響します。Vim と Neovim に個別の設定が必要な場合は、次の方が適切な選択になります:
 export GVIMINIT='let $MYGVIMRC = !has("nvim") ? "$XDG_CONFIG_HOME/vim/gvimrc" : "$XDG_CONFIG_HOME/nvim/init.gvim" | so $MYGVIMRC'
 export VIMINIT='let $MYVIMRC = !has("nvim") ? "$XDG_CONFIG_HOME/vim/vimrc" : "$XDG_CONFIG_HOME/nvim/init.vim" | so $MYVIMRC'

* https://jorengarenar.github.io/blog/vim-xdg
* https://tlvince.com/vim-respect-xdg

== プラグイン ==

vim にプラグインを追加することで、Vim の機能が拡張され、生産性が向上します。プラグインは、Vim の UI の変更、新しいコマンドの追加、コード補完サポートの有効化、他のプログラムやユーティリティと Vim との統合、追加言語のサポートの追加などを行うことができます。

{{Tip|人気のあるプラグインのリストについては、[https://vimawesome.com/ Vim Awesome] を参照してください。}}

=== インストール ===

==== 内蔵のパッケージマネージャを使う ====

Vim 8 では、サードパーティのプラグインをネイティブにロードできる機能が追加されました。この機能は、サードパーティのパッケージを {{ic|~/.vim/pack}} フォルダーに保存することで使用できます。このフォルダーの構造は、通常プラグインごとに1つのディレクトリを持つ一般的なプラグインマネージャーの構造とは少し異なります。以下は一般的なインストール手順とディレクトリ構造です (例として [https://github.com/tpope/vim-surround Tim Pope の vim-surround プラグイン] を使用):

 $ mkdir -p ~/.vim/pack/tpope/start

{{ic|~/.vim/pack/tpope}} はパッケージディレクトリであり、[https://vimhelp.org/repeat.txt.html#packages Vim documentation] では1つ以上のプラグインを含むディレクトリとして大まかに定義されていることに注意することが重要です。ただし、プラグインリポジトリはこのディレクトリにダウンロードしないでください。パッケージディレクトリの名前も任意です。すべてのプラグインを1つのパッケージディレクトリに保存するか、この例のように作成者の GitHub 名 {{ic|tpope}} を使用するかを選択できます。

パッケージディレクトリには次のサブフォルダーを含めることができます:

* {{ic|start}} - このサブフォルダーのプラグインは、Vim の起動時に自動的にロードされます。ここは最も頻繁に使用される場所です。
* {{ic|opt}} - このサブフォルダーのプラグインは、Vim 内で {{ic|:packadd}} コマンドを発行することでオンデマンドでロードできます。

次に、{{ic|start}} フォルダーに移動し、プラグインリポジトリをチェックアウトします:

 $ cd ~/.vim/pack/tpope/start
 $ git clone https://tpope.io/vim/surround.git

これにより、追加のサブフォルダー {{ic|~/.vim/pack/tpope/start/surround}} が作成され、そこにプラグインファイルが配置されます。

次に、プラグインにヘルプファイルが含まれている場合は、ヘルプインデックスを更新します:

 $ vim -u NONE -c "helptags surround/doc" -c q

これで Vim の起動時にプラグインが自動的にロードされるようになります。プラグイン固有のオプションを除き、{{ic|~/.vimrc}} を変更する必要はありません。

==== プラグインマネージャを使う ====

プラグインマネージャーは、Vim プラグインをインストール、管理、更新するプラグインです。これは、Arch Linux 以外のプラットフォームでも Vim を使用していて、プラグインを更新する一貫した方法が必要な場合に役立ちます。

* [https://github.com/junegunn/vim-plug Vim-plug] はミニマルな Vim プラグインマネージャです。必要に応じてプラグインをロードしたり並列アップデートなどの多数の機能を備えています。{{AUR|vim-plug}} または {{AUR|vim-plug-git}} として利用できます。
* [https://github.com/gmarik/Vundle.vim Vundle] {{AUR|vundle}} または {{AUR|vundle-git}} として利用できます。
* [https://github.com/tpope/vim-pathogen pathogen.vim] Vim のランタイムパスを管理するためのシンプルなプラグインで、{{AUR|vim-pathogen}} または {{AUR|vim-pathogen-git}} として利用できます。
* [https://github.com/Shougo/dein.vim Dein.vim] [https://github.com/Shougo/neobundle.vim NeoBundle] に代わるプラグインマネージャーで、{{AUR|vim-dein}} または {{AUR|vim-dein-git}} として入手できます。

==== Arch のリポジトリを使う ====

{{Grp|vim-plugins}} グループには様々なプラグインが入っています。{{ic|pacman -Sg vim-plugins}} コマンドを使うことで pacman で[[インストール]]できるパッケージのリストを確認できます。

=== 注目のプラグイン ===

==== cscope ====

[http://cscope.sourceforge.net/ Cscope] はプロジェクトを閲覧するためのツールです。単語/シンボル/関数まで移動して (ショートカットキーを使って) cscope を呼び出すことで次のことがわかります: 関数を呼び出している関数や、関数の定義など。コードベースを検索するには複数の手順が必要です。

{{Pkg|cscope}} パッケージを [[インストール]] してください。

cscope のデフォルトファイルを vim が自動的に読み取るところへコピーします:
 mkdir -p ~/.vim/plugin
 wget -P ~/.vim/plugin http://cscope.sourceforge.net/cscope_maps.vim 

{{Note|Vim 7.x で cscope ショートカットを有効にするには、おそらく {{ic|~/.vim/plugin/cscope_maps.vim}} でこれらの行のコメントを解除する必要があります。:
{{bc|1=
set timeoutlen=4000
set ttimeout
}}}}

cscope にインデックス化して欲しいファイルを記述したファイルを作成 (Cscope は多数の言語を扱えますがこの例では .c, .cpp, .h ファイルを find しています):

 $ cd ''/path/to/project/dir''
 $ find . -type f -print | grep -E '\.(c(pp)?|h)$' > cscope.files

cscope が読み取るデータベースファイルを作成します:

 cscope -bq

{{Note|この場所からプロジェクトファイルを閲覧するか、{{ic|$CSCOPE_DB}} 変数を設定して {{ic|cscope.out}} ファイルの場所を指定してください。}}

デフォルトのキーボードショートカット:

  Ctrl-\ and
       c: Find functions calling this function
       d: Find functions called by this function
       e: Find this egrep pattern
       f: Find this file
       g: Find this definition
       i: Find files #including this file
       s: Find this C symbol
       t: Find assignments to

ショートカットは自由に変更することができます。

 #Maps ctrl-c to find functions calling the function 
 nnoremap <C-c> :cs find c <C-R>=expand("<cword>")<CR><CR>

==== Taglist ====

[http://vim-taglist.sourceforge.net/ Taglist] はソースコードファイルの構造の概観を提供し、様々なプログラミング言語で書かれたソースコードファイルを効率的に閲覧できるようにします。

{{AUR|vim-taglist}} パッケージを[[インストール]]してください。

{{ic|~/.vimrc}} に記述する有用なオプション:
 let Tlist_Compact_Format = 1
 let Tlist_GainFocus_On_ToggleOpen = 1
 let Tlist_Close_On_Select = 1
 nnoremap <C-l> :TlistToggle<CR>

== トラブルシューティング ==

=== gVim が遅い ===

Vim の GTK3GUI は GTK2 バージョンよりも遅い場合があります({{Bug|51366}} を参照)  {{Aur|gvim-gtk2}} を回避策としてインストールしてみて下さい。

=== 双方向サポート ===

Vim は依然として [[双方向テキスト#サポート|完全な双方向サポートが不足]] であり、これは端末によって異なります。

{{ic|:rightleft}} を使用してテキストの位置を強制的に揃えます。以下を使用してキーバインドに割り当てることができます。

 inoremap <C-X> <C-O>:silent if &rl <Bar> set rl! <Bar> else <Bar> set rl <Bar> endif<CR>

Vim には独自の文字整形機能があります。いくつかの [https://github.com/vim/vim/issues/14115 レンダリングの問題] にもかかわらず、これは [[alacritty]] や [[st]] のような文字整形をサポートしていない端末でも機能します。整形は [http://unicode.org/charts/PDF/UFE70.pdf アラビア語プレゼンテーションフォーム-B (U+FE70–FEFF)] に依存するため、フォントにこれらの文字のサポートが含まれていることを確認してください。これらの文字を完全にサポートする既知の等幅フォントがないため、追加のフォールバックフォント (例: {{pkg|ttf-dejavu}} へのフォールバックを備えた {{AUR|vazir-code-fonts}}) が必要です。端末フォントの設定例については、[[St#アラビア語シェーピングのサポート]] を参照してください。

ただし、端末が gnome-terminal やその他の libvte ベースの端末のような文字整形をサポートしている場合、Vim と端末の文字整形が競合する可能性があります。現在の回避策は、{{ic|:set arabicshape!}} による整形を無効にすることですが、これにより、{{ic|:set rightleft}} のときにテキストが反転してしまうことに注意してください。詳細については、[https://vim-jp.org/vimdoc-en/arabic.html :set arabic] を参照してください。

==参照==

===公式===
* [http://www.vim.org/ ホームページ]
* [http://vimdoc.sourceforge.net/ ドキュメント]
* [http://vim.wikia.com Vim Wiki]
* [http://www.vim.org/scripts/ Vim Scripts]

=== チュートリアル ===

* [https://danielmiessler.com/study/vim/ vim Tutorial and Primer]
* [http://usalug.org/vi.html vi Tutorial and Reference Guide]
* [http://www.viemu.com/a_vi_vim_graphical_cheat_sheet_tutorial.html Graphical vi-Vim Cheat Sheet and Tutorial]
* [http://blog.interlinked.org/tutorials/vim_tutorial.html Vim Introduction and Tutorial]
* [http://www.openvim.com/ Open Vim] - Vim 学習ツールのコレクション。
* [http://yannesposito.com/Scratch/en/blog/Learn-Vim-Progressively/ Learn Vim Progressively]
* [http://benmccormick.org/learning-vim-in-2014/ Learning Vim in 2014]
* [http://www.moolenaar.net/habits.html Seven habits of effective text editing]
* [http://bencrowder.net/files/vim-fu/ Basic Vim Tips]

==== 動画 ====

* [http://vimcasts.org/ Vimcasts] - ''.ogg'' 形式のスクリーンキャスト。
* [http://derekwyatt.org/vim/tutorials/ Vim Tutorial Videos] - 基本事項から高度な話題までカバー。

==== チートシート ====

* https://devhints.io/vim
* https://vim.rtorr.com/ - モバイルフレンドリーな Vim のチートシート。 - [https://github.com/rtorr/vim-cheat-sheet Sources]

==== ゲーム ====

* [http://vim-adventures.com/ Vim Adventures]
* [http://vimgolf.com/ VimGolf]

===設定===
* [https://web.archive.org/web/20131020125020/http://nion.modprobe.de/setup/vimrc nion's]
* [http://amix.dk/vim/vimrc.html A detailed configuration from Amir Salihefendic]
* [https://web.archive.org/web/20131004071740/http://www.jukie.net/~bart/conf/vimrc Bart Trojanowski]
* [https://github.com/spf13/spf13-vim Steve Francia's Vim Distribution]
* [http://vimawesome.com/ Vim Awesome] - Vim プラグイン
* [https://github.com/W4RH4WK/dotVim W4RH4WK の Vim 設定]
* [https://www.askapache.com/linux/fast-vimrc/ Fast vimrc/colorscheme from askapache]
* [https://gist.github.com/anonymous/c966c0757f62b451bffa Basic vimrc]
* [http://www.usevim.com/ Usevim]

====カラー====

* [http://bytefluent.com/vivify/ Vivify] — Vim のカラースキームエディタ。
* [https://linuxtidbits.wordpress.com/2014/10/14/vim-customize-installed-colorschemes/ Vim colorscheme customization]