【Mac】Lazy.nvimで最初にやっておきたい初期設定

こんにちは。ナミレリです。

今回はNeovimのプラグインマネージャであるLazy.nvimを紹介していきます。私はPacker.nvimを使ってきましたが、やっと念願のLazy.nvimに移行しました。移行してみた感想ですが、Lazy.nvimはUIも快適で、何より高速なでパフォーマンスが高く、また、プラグインの設定もスマートに記述することができる点が気に入っています。（が、最初は慣れが必要でした）

Packer.nvimから移行を検討している方や、Neovimのプラグイン管理に悩んでいる方、より効率的な開発環境を構築したい方は、ぜひLazy.nvimを活用するためにこの記事を参考にしてみてください。

この記事はこんな人にオススメ

• プラグインマネージャであるLazy.nvimを使ってみたい方
• Packer.nvimからLazy.nvimへ移行を検討している方
• Lazy.nvimの実際の使用例を知りたい方
• Lazy.nvimのLuaによる記述方法を知りたい方

この記事のMac環境

• M3 MacBook Air 15インチ
• macOS Sonoma 14.5
• NVIM v0.10.1
• Parallels Desktop 19 for Mac バージョン 19.3.0 (54924)

Parallels Desktop 20 for Macの無料トライアル もありますので、ぜひダウンロードして試してみてください。M1/M2/M3のMac上で快適にMacやUbuntu、Windowsが動作します。

はじめに

私はプラグインマネージャとしてPacker.nvimを使っていますが、Packer.nvimは2023年8月以降メンテナンスされていません。Packer.nvimの代替としてLazy.nvimとPckr.nvimが案内されています。今回は主流であるLazy.nvimに移行していきます。

Packer.nvimからLazy.nvimへ移行する方、新規にLazy.nvimを導入する方にわかりやすく紹介したいと思います。

Lazy.nvimとは？

Lazy.nvimは、Neovim向けの新しいプラグインマネージャで効率的かつ使いやすい設計が特徴で人気です。

Lazy.nvimは、Packer.nvimの機能を拡張しさらにユーザーの利便性を高めるために開発されました。特に、パフォーマンスの向上や設定の簡略化に重点を置いています。

Packer.nvimから移行して感じることは、とにかく速い！UIがカッコイイ！ことです。少し慣れてくると、プラグイン毎に遅延ロードを細かく設定できるので、中級者以上も満足するパフォーマンスのチューニングが楽しくなります。

主な特徴としては以下の通りです。

Lazy.nvimの見た目

Packer.nvimとLazy.nvimの記述の比較

まずは、簡単にLazy.nvimの記述例をPacker.nvimと比較して見てみましょう。

例：Packer.nvimでのneo-tree.nvim設定

use {
    "nvim-neo-tree/neo-tree.nvim",
    branch = "v3.x",
    requires = {
        "nvim-lua/plenary.nvim",
        "nvim-tree/nvim-web-devicons",
        "MunifTanjim/nui.nvim",
        "3rd/image.nvim",
    },
    require("neo-tree").setup({
        window = {
            position = "right",
        },
    })
}

例：Lazy.nvimでのneo-tree.nvim設定

return {
    {
        "nvim-neo-tree/neo-tree.nvim",
        branch = "v3.x",
        dependencies = {
            "nvim-lua/plenary.nvim",
            "nvim-tree/nvim-web-devicons",
            "MunifTanjim/nui.nvim",
            "3rd/image.nvim",
        },
        opts = {
            window = {
                position = "right",
            },
        },
        cmd = "Neotree",
    },
}

上記の例でのPacker.nvimとLazy.nvimの記述の違いは下のようになります。

他にも違いはありますが、上記の例では一旦こんな感じです。

また、上記の例でもopts = {}が出てきましたが、以下のようにLazy.nvimは、config = function()の代わりにopts = {}を書くのが良い例です。

{ "folke/todo-comments.nvim", opts = {} },

{
  "folke/todo-comments.nvim",
  config = function()
    require("todo-comments").setup({})
  end,
},

それでは、Lazy.nvimでかっこよく使いやすいNeovim環境を構築していきましょう。まずは既存環境をバックアップしておきます。

既存環境のバックアップ

Packer.nvimを使っている方は、Lazy.nvimをインストールする前に、既存の設定ファイル等をリネームしてバックアップしておきます。

Lazy.nvimが肌に合わずに元の環境に戻したい場合に備えて、必ずやっておきます。

以下の3つのディレクトリをリネームしてバックアップします。

mv ~/.config/nvim ~/.config/nvim_backup

mv ~/.local/share/nvim ~/.local/share/nvim_backup

mv ~/.local/state/nvim ~/.local/state/nvim_backup

Lazy.nvimのインストール

バックアップが済んだら、真っ新なNeovim環境にLazy.nvimをインストールしていきます。Lazy.nvimのインストールは、公式を参考にして進めていきます。

Lazy.nvimのインストールは、Neovimの設定ファイルであるinit.luaにブートストラップのスクリプトを書きインストールします。

init.luaにブートストラップスクリプトを書かずに、別のファイル（例えば）~/.config/nvim/lua/config/lazy.luaにブートストラップを記述し、init.luaからそのファイルをrequireする方法などもありますが、

今回は、init.luaにブートストラップのスクリプトを書き、また構成は以下のようにしてみます。

Neovimのディレクトリ構成

ディレクトリ構成はこだわりや好みで自由に構成することができます。

このブログではLazy.nvim用に下のような構成にします。

~/.config/nvim/
├── init.lua    --> bootstrap script
└── lua/
       ├── plugins/
       │       ├── plugins_lazy.lua
       │       ├── plugin1_cfg.lua
       │       └── plugin2_cfg.lua
       ├── core/
       │       ├── autocmds.lua
       │       ├── keymaps.lua
       │       └── options.lua
       └── user/
               └── ui.lua

ディレクトリやファイルの作成

まずは上で紹介した、Neovimのディレクトリ構成（空のディレクトリや空のファイル）を下のコマンドで作ります。

以下のコマンドで、Neovimのディレクトリ構成を作ります。

mkdir -p ~/.config/nvim/lua/plugins && \
mkdir -p ~/.config/nvim/lua/core && \
mkdir -p ~/.config/nvim/lua/user && \
touch ~/.config/nvim/init.lua && \
touch ~/.config/nvim/lua/core/autocmds.lua && \
touch ~/.config/nvim/lua/core/keymaps.lua && \
touch ~/.config/nvim/lua/core/options.lua && \
touch ~/.config/nvim/lua/plugins/plugins_lazy.lua && \
touch ~/.config/nvim/lua/user/ui.lua && \
echo 'return {}' > ~/.config/nvim/lua/plugins/plugins_lazy.lua

最後の、echo 'return {}' > ○○ですが、プラグインリストを定義するファイル（plugins_lazy.lua）はテーブルで返す必要があるため、return {}という形式で空のテーブルを返すための記述を書いています。

こうすることで、plugins_lazy.luaを適切に書くまでエラーなくNeovimを起動することができます。

Luaのテーブルについて

先程のようなLuaのテーブルは、連想配列（ハッシュ）として機能し、キーと値のペアでデータを保持します。テーブルは以下のように作成できます。

local my_table = {
  key1 = "value1",
  key2 = "value2",
  key3 = {
        sub1 = "value3",
        sub2 = "value4",
    },
}

便利なブートストラップスクリプト

事前にLazy.nvimをインストールしていなくても、Lazy.nvimのインストール状態をチェックし、必要な場合は自動的にインストールするように設定します。

公式リポジトリのこちらの記述を参考にしつつも、より便利にカスタマイズしながらやってみましょう。

~/.config/nvim/init.luaを下のように編集します。

nvim ~/.config/nvim/init.lua

~/.config/nvim/init.lua

-- lazy.nvim boot strap
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
    vim.fn.system({
        "git",
        "clone",
        "--filter=blob:none",
        "https://github.com/folke/lazy.nvim.git",
        "--branch=stable",
        lazypath,
    })
end
vim.opt.rtp:prepend(lazypath)

-- local plugins
local plugins = {
    { import = "plugins" },
}

-- local opts
local opts = {
    root = vim.fn.stdpath("data") .. "/lazy",
    lockfile = vim.fn.stdpath("config") .. "/lazy-lock.json",
    concurrency = 10,
    checker = { enabled = true },
    log = { level = "info" },
}

-- leader key
vim.g.mapleader = " "

-- lazy setup
require("lazy").setup(plugins, opts)

-- require core/ and user/
require("core.options")
require("core.autocmds")
require("core.keymaps")
require("user.ui")

-- lazy.nvim boot strap
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
    vim.fn.system({
        "git",
        "clone",
        "--filter=blob:none",
        "https://github.com/folke/lazy.nvim.git",
        "--branch=stable",
        lazypath,
    })
end
vim.opt.rtp:prepend(lazypath)

-- local plugins
local plugins = {
    { import = "plugins" },
}

-- 例：~/.config/nvim/lua/plugins/*.lua
return {
    -- colorscheme
    {
        "catppuccin/nvim",
        name = "catppuccin",
        priority = 1000,
        config = function()
            vim.cmd.colorscheme("catppuccin")
        end,
    },
}

-- local opts
local opts = {
    root = vim.fn.stdpath("data") .. "/lazy",
    lockfile = vim.fn.stdpath("config") .. "/lazy-lock.json",
    concurrency = 10,
    checker = { enabled = true },
    log = { level = "info" },
}

-- leader key
vim.g.mapleader = " "

-- lazy setup
require("lazy").setup(plugins, opts)

起動とLazyコマンドについて

起動

Neovimを再度起動してみましょう。以下のメッセージが表示されたらENTERを押して続けます。

nvim

Neovimが起動したら、:LazyでLazy.nvimを起動します。

Lazy.nvimの画面を抜けるにはqです

Lazyコマンド

以下がLazy.nvimの画面でのキーボードショートカットです。

Lazy.nvimの画面を抜けるにはqです

続いて、~/.config/nvim/lua/core/配下の設定ファイルを記述していきます。

~/.config/nvim/lua/core/配下のファイルについて

それでは、~/.config/nvim/lua/core/配下の各ファイルの設定をしていきます。と言ってもkeymaps.luaとautocmds.luaは現段階では空のファイルとしておき、options.luaのみ設定していきます。

options.luaについて

先程紹介したinit.luaでrequireするファイルは以下の4つですが、この段階ではoptions.luaのみ設定します。

options.luaの内容については、下の記事を参考に設定してください。

関連

【Mac】Neovimの最初にやっておきたい初期設定

keymaps.luaについて

（このブログでは）keymaps.luaには、様々なインストールしたプラグインインのkeymapを設定するファイルとします。現段階で空のファイルです。

autocmds.luaについて

（このブログでは）autocmds.luaには、特定のイベントが発生したときに自動的に実行するコマンドを記述するファイルとします。vim.api.nvim_create_autocmd関数（やvim.api.nvim_create_augroup関数）を使用して自動コマンドを設定します。現段階で空のファイルです。

プラグインのインストール準備

plugins_lazy.luaは以下のようにluaテーブルで記述していきます。

plugins_lazy.luaの記述例

return {
	{ "folke/todo-comments.nvim", opts = {} },
}

デザイン・UI関連のプラグイン

以前の記事でも紹介した私のおすすめする（使っている）見た目、デザインやUIに関わるプラグインをベースにLazy.nviでインストールしていきます。プラグインの概要や設定方法を紹介していきます。

関連

【Mac】Neovimのおすすめプラグイン（見た目をクールに！デザイン・UI関連）

デザイン・UI関連のおすすめプラグイン

それでは、~/.config/nvim/lua/plugins/plugins_lazy.luaに上のプラグインの設定をしていきます。

カラースキーム（catppuccin/nvim、folke/tokyonight.nvim）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

~/.config/nvim/lua/plugins/plugins_lazy.lua

return {
    -- colorscheme
    {
        "catppuccin/nvim",
        name = "catppuccin",
        lazy = false,
        priority = 1000,

    },

    {
        "folke/tokyonight.nvim",
        lazy = false,
        priority = 1000,
    },
}

この記事ではカラースキームの設定を~/.config/nvim/lua/user/ui.luaに設定します。

nvim ~/.config/nvim/lua/user/ui.lua

~/.config/nvim/lua/user/ui.lua

-- colorscheme
vim.cmd.colorscheme "catppuccin-macchiato"
-- vim.cmd.colorscheme "tokyonight-storm"

ここで一旦、Neovimを起動し直し:Lazy syncでプラグインをインストールしてみてください。2つのカラースキームがインストールされます。再度Neovimを起動すると、カラースキームが適用されていると思います。

ファイルブラウザ（nvim-neo-tree/neo-tree.nvim）

~/.config/nvim/lua/plugins/plugins_lazy.luaを編集しますが、

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- file browser
    {
        "nvim-neo-tree/neo-tree.nvim",
        branch = "v3.x",
        dependencies = {
            "nvim-lua/plenary.nvim",
            "nvim-tree/nvim-web-devicons",
            "MunifTanjim/nui.nvim",
        },
        opts = {
            window = {
                position = "right",
            },
            event_handlers = {
                {
                    event = "file_open_requested",
                    handler = function()
                        require("neo-tree.command").execute({ action = "close" })
                    end,
                },
            },
        },
        cmd = "Neotree",
    },

Neovimを起動し直し:Lazy syncでプラグインをインストールしてみてください。Neotreeと必要なプラグインがインストールされます。再度Neovimを起動すると、Neotreeが使えます。

Neotreeのは、:Neotreeで起動します。

keymapは、以下のように<leader>nnに設定しています。

~/.config/nvim/lua/core/keymaps.lua

local vim = vim
local opts = { noremap = true, silent = true } -- local term_opts = { silent = true }
local keymap = vim.keymap.set
-- オプションテーブルにdescを追加するための簡略化関数
local function extend_opts(desc)
    return vim.tbl_extend("force", opts, { desc = desc })
end

-- Neotree
keymap("n", "<leader>nn", ":Neotree toggle<cr>", extend_opts("Neotree Toggle"))

ステータスライン（nvim-lualine/lualine.nvim）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

{
    "nvim-lualine/lualine.nvim",
    dependencies = {
        "nvim-tree/nvim-web-devicons",
    },
    opts = {},
    event = "VeryLazy",
},

タブライン（kdheepak/tabline.nvim）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- tabline
    {
        "kdheepak/tabline.nvim",
        opts = {},
        event = "BufWinEnter",
    },

インデント（echasnovski/mini.indentscope）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- indent
    {
        "echasnovski/mini.indentscope",
        opts = {
            symbol = "▏",
        },
        event = "BufRead",
    },

シンタックスハイライト（nvim-treesitter/nvim-treesitter）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- nvim-treesitter
    {
        "nvim-treesitter/nvim-treesitter",
        event = { "BufRead", "BufNewFile", "InsertEnter" },
        build = ":TSUpdate",
        config = function()
            local configs = require("nvim-treesitter.configs")
            configs.setup({
                ensure_installed = {
                    "awk",
                    "bash",
                    "comment",
                    "c",
                    "css",
                    "csv",
                    "diff",
                    "gpg",
                    "html",
                    "htmldjango",
                    "javascript",
                    "json",
                    "lua",
                    "markdown",
                    "python",
                    "rust",
                    "sql",
                    "ssh_config",
                    "tmux",
                    "toml",
                    "vim",
                    "xml",
                    "yaml",
                    "regex",
                    "vimdoc",
                },
                sync_install = false,
                auto_install = true,
                highlight = { enable = true },
                indent = { enable = true },
            })
        end,
    },

ensure_installedで指定した言語パーサがインストールされます。サポートされている言語の一覧はこちらです。

ポップアップUI（folke/noice.nvim）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- noice
    {
        "folke/noice.nvim",
        event = "VeryLazy",
        dependencies = {
            "MunifTanjim/nui.nvim",
            "rcarriga/nvim-notify",
        },
        opts = {
            routes = {
                {
                    filter = { event = "msg_show", find = "E486: Pattern not found: .*" },
                    opts = { skip = true },
                },
            },
            lsp = {
                -- override markdown rendering so that **cmp** and other plugins use **Treesitter**
                override = {
                    ["vim.lsp.util.convert_input_to_markdown_lines"] = true,
                    ["vim.lsp.util.stylize_markdown"] = true,
                    ["cmp.entry.get_documentation"] = true, -- requires hrsh7th/nvim-cmp
                },
            },
        },
    },

gitのサイン表示（lewis6991/gitsigns.nvim）

nvim ~/.config/nvim/lua/plugins/plugins_lazy.lua

最上部のreturn{と最下部にある}は省略します。

~/.config/nvim/lua/plugins/plugins_lazy.lua

    -- git
    {
        "lewis6991/gitsigns.nvim",
        config = true,
        event = { "BufReadPre", "BufNewFile" },
    },

起動時間

Lazy.nvimでは、:Lazy profileで起動時間を確認することができます。この記事で紹介したプラグインをインストールした状態で、29.57msとなりました。

最後に

最後まで読んでいただきありがとうございます。今回のLazy.nvimで最初にやっておきたい初期設定はいかがでしたでしょうか。

次回はLSPの設定を紹介します。https://namileriblog.com/mac/lazy_nvim_lsp/

究極のコーディング体験：NeovimとHHKBで高める生産性

NeovimとHHKBの組み合わせは、コーディング体験を最適化し、より生産的で満足のいくものにするための最高のツールです。コーディングの楽しさと効率性を新たなレベルへと引き上げてくれます。

実践Vim　思考のスピードで編集しよう！ (アスキー書籍)

• Kindle本で探す
• Amazonで探す
• 楽天市場で探す
• Yahooショッピングで探す

PFU キーボード HHKB Studio 日本語配列 (ポインティングスティック メカニカルキーボード)

HHKB

• Amazonで探す
• 楽天市場で探す
• Yahooショッピングで探す

HHKB Professional HYBRID Type-S 日本語配列／墨

HHKB

• Amazonで探す
• 楽天市場で探す
• Yahooショッピングで探す

定番おすすめ記事

Neovimをかっこ良くクールに使う設定

MacでもUbuntuでもNeovimをかっこ良くクールに使う設定を紹介！

関連

【Mac】Lazy.nvimで最初にやっておきたい初期設定

関連

【Mac】Lazy.nvimでPythonとLuaのLSP環境を構築する方法

関連

【Mac】Neovimのdiagnosticsアイコンを変更する

関連

【Mac】Neovimの最初にやっておきたい初期設定

関連

【Mac】Neovimのおすすめプラグイン（見た目をクールに！デザイン・UI関連）

関連

【Mac】NeovimでPythonとLuaのLSP環境を構築する方法

関連

【Mac】NeovimでTelescopeを設定する

関連

【Mac】Neovimを半透明でかっこ良く設定する：neovim transparent

関連

【Mac】NeovimのステータスラインにIMEの状態を表示する

関連

【Mac】Neovimのスムーズスクロールとカーソル移動アニメーションでかっこ良くする

関連

【Mac】NeovimのGUI、Neovideのインストールと設定

関連

【Mac】NeovimでChatGPTと会話する