Neovim講座 / 02 インストール

インストール

Mac・Linux への Neovim インストールと初回起動まで
入門 セットアップ
目次
  1. Mac へのインストール（Homebrew）
  2. Linux へのインストール
  3. インストール確認
  4. 初回起動
  5. vimtutor を使う
  6. よくあるトラブルと解決法

Mac へのインストール（Homebrew）

Mac では Homebrew を使うのが最も簡単です。 Homebrew が未インストールの場合はまず Homebrew を入れましょう。

1

Homebrew のインストール（未インストールの場合）

ターミナルを開き、以下のコマンドを貼り付けて実行します。

Terminal
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
==> Checking for `sudo` access (which may request your password)...
==> Homebrew is ready to brew!
ℹ️
Homebrewが既に入っている場合 brew --version でバージョンが表示されれば、このステップはスキップしてください。
2

Neovim のインストール

Homebrew で Neovim をインストールします。安定版と最新のナイトリービルドを選べます。

Terminal
# 安定版（推奨）
$ brew install neovim
 
# 最新のナイトリービルド（最新機能を使いたい場合）
$ brew install --HEAD neovim

インストールには数分かかる場合があります。依存ライブラリも自動でインストールされます。

3

インストールの確認

Terminal
$ nvim --version
NVIM v0.10.2
Build type: Release
LuaJIT 2.1.1723675123
Run "nvim -V1 -v" for more info

バージョン番号が表示されれば成功です。

4

Neovim のアップデート方法

今後 Neovim をアップデートしたい場合は以下を実行します。

Terminal
$ brew upgrade neovim

Linux へのインストール

Linux ではディストリビューションのパッケージマネージャーを使う方法と、 公式の AppImage / バイナリを使う方法があります。 注意： パッケージマネージャー経由だとバージョンが古い場合があります。 Neovim 0.9 以上を推奨します。

Ubuntu / Debian（apt）

Terminal — Ubuntu/Debian
# PPA を追加して最新版を取得（推奨）
$ sudo add-apt-repository ppa:neovim-ppa/stable
$ sudo apt update
$ sudo apt install neovim
 
# または標準リポジトリから（バージョンが古い場合あり）
$ sudo apt install neovim

Fedora / RHEL（dnf）

Terminal — Fedora
$ sudo dnf install neovim python3-neovim

Arch Linux（pacman）

Terminal — Arch Linux
$ sudo pacman -S neovim

最新版を使いたい場合：AppImage

ディストリのパッケージが古い場合は、GitHub リリースページから AppImage を取得するのが確実です。

Terminal — AppImage
$ curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz
$ tar xzf nvim-linux64.tar.gz
$ sudo mv nvim-linux64 /opt/nvim
$ sudo ln -s /opt/nvim/bin/nvim /usr/local/bin/nvim

インストール確認

どの OS でも、インストール後は以下のコマンドで確認します。

Terminal
# バージョン確認
$ nvim --version
NVIM v0.10.2
 
# コマンドの場所を確認
$ which nvim
/opt/homebrew/bin/nvim
 
# ヘルスチェック（内部チェック）— 起動後に実行
:checkhealth
💡
:checkhealth で環境を確認しよう Neovim 起動後に :checkhealth コマンドを実行すると、 Python、Node.js、クリップボードなどの設定状態を自動チェックしてくれます。 初期設定後に必ず実行することをお勧めします。

初回起動

1

Neovim を起動する

ターミナルで nvim と入力して Enter を押します。

Terminal
$ nvim

黒い画面に Neovim のロゴとウェルカムメッセージが表示されます。これが Normal モード（後の章で詳しく解説）の状態です。

2

ファイルを指定して開く

Terminal
# 既存ファイルを開く
$ nvim myfile.txt
 
# 新規ファイルを作成して開く
$ nvim newfile.lua
3

Neovim を終了する

最初に誰もが戸惑うのが「どうやって終了するか」です。

Neovim
# 保存せず終了
:q
 
# 保存して終了
:wq
 
# 強制終了（変更を破棄）
:q!
⚠️
コマンドを入力する前に Esc を押す 何かおかしいと思ったら、まず Esc を1〜2回押してください。 Normal モードに戻ってから :q などのコマンドを入力します。

vimtutor を使う

Neovim には vimtutor という対話型チュートリアルが内蔵されています。 約25〜30分で基本操作を体験できる、最良の入門方法です。

Terminal
# Neovim の vimtutor を起動
$ nvim +Tutor
 
# 日本語版（環境によっては利用可能）
$ LANG=ja nvim +Tutor

チュートリアルでは実際にファイルを編集しながら、基本コマンドを学べます。 移動（hjkl）、削除（dd）、挿入（i）、保存（:w）など、最重要コマンドがすべてカバーされています。 このチュートリアルを最低1回は完走することを強く推奨します。

🎯
vimtutor は繰り返すほど効果がある 最初は「覚えられない」と感じても大丈夫です。2〜3回繰り返すうちに、 コマンドが指に馴染んできます。最初の1週間は毎日 vimtutor を起動する習慣をつけましょう。

よくあるトラブルと解決法

問題1: nvim コマンドが見つからない

⚠️
command not found: nvim brew install neovim 後にこのエラーが出る場合、PATH が通っていない可能性があります。
Terminal — 解決法
# ~/.zshrc または ~/.bash_profile に追加
$ echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc

問題2: 文字化けする・日本語が入力できない

init.lua（設定ファイル）に以下を追加してください。

lua ~/.config/nvim/init.lua 
-- 文字コードの設定
vim.opt.encoding = "utf-8"
vim.opt.fileencoding = "utf-8"

問題3: クリップボードが使えない（Mac）

Terminal
# pbcopy/pbpaste が使える Mac では通常は自動設定されるが
# init.lua に以下を追加すると確実
vim.opt.clipboard = "unnamedplus"

問題4: ターミナルの色が正しく表示されない

ターミナルアプリが True Color（24-bit color）に対応しているか確認してください。 Mac では iTerm2 または Alacritty を推奨します。 macOS 標準の Terminal.app は True Color 対応が限定的です。

lua ~/.config/nvim/init.lua 
-- True Color を有効にする
vim.opt.termguicolors = true
←
前のページ
背景・なぜNeovimか
Neovim講座 — 初心者からはじめるNeovim  |  Chapter 02