> For the complete documentation index, see [llms.txt](https://dofy.gitbook.io/learn-vim/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dofy.gitbook.io/learn-vim/ja.md).

# Vim 実践チュートリアル（Learning Vim）

[English](https://dofy.gitbook.io/learn-vim/en.md) | [简体中文](https://dofy.gitbook.io/learn-vim/zh-cn.md) | [日本語](https://dofy.gitbook.io/learn-vim/ja.md)

> \[!TIP]
>
> ブラウザで読みながら練習したい場合は、教材と Vim 形式の練習エディタを並べた インタラクティブ版を利用できます： [learning-vim.phpz.org](https://learning-vim.phpz.org/)。 Web プロジェクトのソースコードは [dofy/learning-vim](https://github.com/dofy/learning-vim) で公開しています。

## はじめに

私自身の経験では、ドキュメントを読んだり他の人の操作を眺めたりするだけで Vim を 身につけるのは簡単ではありません。実際の環境と具体的な場面で操作し、コマンドに 慣れていく必要があります。

そこで本プロジェクトでは、学習と操作を同時に進められるよう、すべての教材を Markdown ファイルとして用意しています。説明文として読むことも、Vim で直接開いて 実際に操作することもできます（後者をおすすめします）。

## 使い方

1. プロジェクトをローカルにクローンします。

```bash
git clone https://github.com/dofy/learn-vim.git
```

2. プロジェクトの日本語ディレクトリへ移動します。

```bash
cd learn-vim/ja
```

3. 最初のファイル `vim-modes.md` を Vim で開きます。

```bash
vim vim-modes.md
```

Vim を初めて使う場合は、先に [Vim のモード](https://dofy.gitbook.io/learn-vim/ja/vim-modes.md)を一読してください。 暗記する必要はありません。`Esc` でノーマルモードへ戻り、そこから次の操作を始める ことだけ覚えておきましょう。

## 表記ルール

```markdown

## 大見出しは大きなカテゴリを表します

### 小見出しはそのカテゴリ内のサブカテゴリを表します

装飾のない文章は、読むための通常の説明文です。

> 引用ブロック内の文章は実際に行う操作です。書かれている内容に従って
> 操作してください。
>
> `:w` のように記号で囲まれたものは、演算子またはコマンドです。

f<X> のようなコマンドにある < と > は入力しません。<X> は変数を表すため、
fa、fb、fC などと入力できます。

_注意：コマンドでは大文字と小文字が区別されます（注意事項はこの行のように
記載します）。_

```

> \[!NOTE]
>
> すでに自分の `.vimrc` を使用していて（[第 4 章](https://dofy.gitbook.io/learn-vim/ja/chapter04.md)を参照）、 デフォルト設定を変更している場合、一部の操作がチュートリアルどおりにならない ことがあります。その場合は、次のコマンドで `Vim` を起動できます。
>
> ```bash
> # 設定ファイルを読み込まない
> vim -u NONE
> # 指定した設定ファイルを読み込む
> vim -u <filename>
> ```

## 目次

### 基本操作

1. [始める前に：Vim のモード](https://dofy.gitbook.io/learn-vim/ja/vim-modes.md)
2. [第 1 章：カーソルの移動](https://dofy.gitbook.io/learn-vim/ja/chapter01.md)
3. [第 2 章：ファイルを開く、内容を検索する](https://dofy.gitbook.io/learn-vim/ja/chapter02.md)
4. [第 3 章：文書の編集と保存](https://dofy.gitbook.io/learn-vim/ja/chapter03.md)
5. [第 4 章：便利なテクニック](https://dofy.gitbook.io/learn-vim/ja/chapter04.md)
6. [第 5 章：画面分割とタブ](https://dofy.gitbook.io/learn-vim/ja/chapter05.md)
7. [第 6 章：ブロック操作](https://dofy.gitbook.io/learn-vim/ja/chapter06.md)
8. [第 7 章：Vim のマクロ](https://dofy.gitbook.io/learn-vim/ja/chapter07.md)
9. [第 8 章：テキストオブジェクト](https://dofy.gitbook.io/learn-vim/ja/chapter08.md)
10. [第 9 章：レジスタとクリップボード](https://dofy.gitbook.io/learn-vim/ja/chapter09.md)
11. [第 10 章：マークとジャンプ](https://dofy.gitbook.io/learn-vim/ja/chapter10.md)
12. [第 11 章：複数ファイルの検索と置換](https://dofy.gitbook.io/learn-vim/ja/chapter11.md)

### 追加コンテンツ

1. [Vim プラグイン](https://dofy.gitbook.io/learn-vim/ja/vim-plugin.md)
2. [おすすめプラグイン](https://dofy.gitbook.io/learn-vim/ja/plugins/index.md)
   1. [NERDTree](https://dofy.gitbook.io/learn-vim/ja/plugins/nerdtree.md)
   2. [EasyAlign](https://dofy.gitbook.io/learn-vim/ja/plugins/easyalign.md)
   3. [Airline とテーマ](https://dofy.gitbook.io/learn-vim/ja/plugins/airline.md)
   4. [surround.vim](https://dofy.gitbook.io/learn-vim/ja/plugins/surround.md)

> \[!NOTE]
>
> * チュートリアル内では、次の章や関連する章へのファイル名にカーソルを置き、 `gf`（goto file）を実行して移動できます。
> * 関連する章を開いた後は、`:bp` で直前のファイルへ戻れます（このコマンドは [第 2 章](https://dofy.gitbook.io/learn-vim/ja/chapter02.md)で扱います）。
> * `:q` や `:qa` で終了すると、ファイルが保存されていないというエラーが出る場合が あります。そのときはコマンドの末尾に `!` を付けてみてください。

## おすすめの Vim 設定

* [dofy / **nvim**](https://github.com/dofy/nvim)（作者が現在使用している Neovim 設定）
* [dofy / **7th-vim**](https://github.com/dofy/7th-vim)
* [kepbod / **ivim**](https://github.com/kepbod/ivim)
* [chxuan / **vimplus**](https://github.com/chxuan/vimplus)
* [SpaceVim / **SpaceVim**](https://github.com/SpaceVim/SpaceVim)

## その他の優れた Vim チュートリアル

* コンソールで `vimtutor` を実行します。Vim 公式の実践チュートリアルです。
* [Concise Vim Practice Tips](https://coolshell.cn/articles/5426.html) 入門に適したチュートリアルです。
* [Vim Galore](https://github.com/mhinz/vim-galore) 頻繁に更新されている必読資料です。
* [Daily Vim](http://liuzhijun.ite.com/category/270228) 全 30 記事で、より幅広い内容を扱っています。
* [A book for learning the Vim editor](https://github.com/iggredible/Learn-Vim) もう一つの Learn Vim（英語）です。
* [Open Vim](https://openvim.com/) インタラクティブな Vim チュートリアルです。
* [QuickRef.ME/vim](https://quickref.me/vim) Vim のチートシートです。

## チートシート

> [Vim Cheat Sheet](https://vim.rtorr.com/lang/zh_tw)

> [A Great Vim Cheat Sheet](https://vimsheet.com/)

> [![003](https://people.csail.mit.edu/vgod/vim/vim-cheat-sheet-en.png)](https://people.csail.mit.edu/vgod/vim/vim-cheat-sheet-en.png)

> [![004](https://cdn.shopify.com/s/files/1/0165/4168/files/preview.png)](https://cdn.shopify.com/s/files/1/0165/4168/files/preview.png)

> [![005](https://raw.githubusercontent.com/Michaelangel007/vim_cheat_sheet/master/vim_cheat_sheet_for_programmers_print_150dpi.png)](https://raw.githubusercontent.com/Michaelangel007/vim_cheat_sheet/master/vim_cheat_sheet_for_programmers_print_150dpi.png)

**ご覧いただきありがとうございます。気に入ったら、ぜひ共有してください。 Love life, love VIM!**
