defx.nvim とは
画像の左の部分がdefx.nvimです。
defxは、かの有名な暗黒美夢王Shougoさんの作成されたdark powerdなvimのファイラ(ファイルエクスプローラ)です。
vimのファイラと言うと、他にもNERDTreeや、同じくShougoさん作のVimFilerなどをお使いの方もいると思います。
体感ですが、defxは他のファイラに比べてかなり動作が早いです。また拡張性もあります。
開発の終了したVimFilerやもっさりしたNERDTreeを卒業し、暗黒の力を手にしましょう。
環境
macOS Catalina
iTerm2
NVIM v0.5.0-ef0398f
NeoVimをインストール
defx.nvimの動作にはNeoVim
またはVim8.1+
とPython3.6.1+
が必要です。僕はNeoVimを強くお勧めします。この機会に移行しましょう。2020年だし。
brewでNeoVimをインストールしただけだとPython3はついてこないので、以下の方法でインストールします。
sudo pip3 install neovim
brew tap neovim/neovim
brew install --HEAD neovim
vimを開いて:echo has("python3")
と打ち込み、1
が返ってきたらOKです。また、deopleteを問題なく使えている方は大丈夫です。
defx.nvimをインストール
- dein.vim
call dein#add('Shougo/defx.nvim')if!has('nvim')call dein#add('roxma/nvim-yarp')call dein#add('roxma/vim-hug-neovim-rpc')endif
- vim-plug
if has('nvim')
Plug 'Shougo/defx.nvim', { 'do': ':UpdateRemotePlugins' }
else
Plug 'Shougo/defx.nvim'
Plug 'roxma/nvim-yarp'
Plug 'roxma/vim-hug-neovim-rpc'
endif
defxはVimFilerとは違い、deinte.nvimに依存しないので、defx単体のみのインストールで大丈夫です。
(dein.vimは非常に優れたプラグインマネージャです。まだ導入してない人はこの機会に導入を検討してはいかがでしょうか)
一般の設定
キーバインド
まず、defxにはデフォルトのキーバインドというものが存在しません。ファイルを開くアクションにも、ディレクトリを移動するアクションも全て自分で設定する必要があります。
とは言っても、公式のドキュメントにお勧めの設定的なやつがのってるので、ほとんどそれをコピペすれば済みます。
autocmd FileType defx calls:defx_my_settings()function!s:defx_my_settings() abort
nnoremap <silent><buffer><expr><CR> \ defx#do_action('drop')
nnoremap <silent><buffer><expr>c \ defx#do_action('copy')
nnoremap <silent><buffer><expr>m \ defx#do_action('move')
nnoremap <silent><buffer><expr>p \ defx#do_action('paste')
nnoremap <silent><buffer><expr>l \ defx#do_action('drop')
nnoremap <silent><buffer><expr>t \ defx#do_action('open','tabnew')
nnoremap <silent><buffer><expr> E
\ defx#do_action('drop','vsplit')
nnoremap <silent><buffer><expr> P
\ defx#do_action('drop','pedit')
nnoremap <silent><buffer><expr>o \ defx#do_action('open_or_close_tree')
nnoremap <silent><buffer><expr> K
\ defx#do_action('new_directory')
nnoremap <silent><buffer><expr> N
\ defx#do_action('new_file')
nnoremap <silent><buffer><expr> M
\ defx#do_action('new_multiple_files')
nnoremap <silent><buffer><expr> C
\ defx#do_action('toggle_columns', \'mark:indent:icon:filename:type:size:time')
nnoremap <silent><buffer><expr> S
\ defx#do_action('toggle_sort','time')
nnoremap <silent><buffer><expr>d \ defx#do_action('remove')
nnoremap <silent><buffer><expr>r \ defx#do_action('rename')
nnoremap <silent><buffer><expr>! \ defx#do_action('execute_command')
nnoremap <silent><buffer><expr>x \ defx#do_action('execute_system')
nnoremap <silent><buffer><expr> yy
\ defx#do_action('yank_path')
nnoremap <silent><buffer><expr>. \ defx#do_action('toggle_ignored_files')
nnoremap <silent><buffer><expr> ;
\ defx#do_action('repeat')
nnoremap <silent><buffer><expr>h \ defx#do_action('cd',['..'])
nnoremap <silent><buffer><expr>~ \ defx#do_action('cd')
nnoremap <silent><buffer><expr>q \ defx#do_action('quit')
nnoremap <silent><buffer><expr><Space> \ defx#do_action('toggle_select').'j'
nnoremap <silent><buffer><expr> *
\ defx#do_action('toggle_select_all')
nnoremap <silent><buffer><expr>j \ line('.')== line('$') ? 'gg':'j'
nnoremap <silent><buffer><expr>k \ line('.')==1 ? 'G':'k'
nnoremap <silent><buffer><expr><C-l> \ defx#do_action('redraw')
nnoremap <silent><buffer><expr><C-g> \ defx#do_action('print')
nnoremap <silent><buffer><expr>cd \ defx#do_action('change_vim_cwd')endfunction
これには若干僕のオリジナルが入っています。
- 僕は、常に作業画面の左側にファイルをツリー表示して置く使い方なので、ファイルを開くときのアクションが
open
ではなくdrop
になっています。 - 公式ドキュメントには載っていませんが、
defx#do_action('open','tabnew')
で、選択したファイルを新しいタブで開くことができます。僕はこれをt
にバインドしました。
各アクションの意味はここ
vim起動時に起動、<Leader>fで起動
VimFilerを使っていたときには、vim起動時に自動的にVimFilerを左側に開き、また<Leader>f
でも開くようにしていたので、同じように設定したいと思います。
このようなキーバインドは各自でお好みで設定してください。
autocmd VimEnter * execute 'Defx'
nnoremap <silent><Leader>f:<C-u> Defx <CR>
起動時のレイアウトや設定
defx起動時の設定をしています。各自お好みで。
call defx#custom#option('_',{ \'winwidth':40, \'split':'vertical', \'direction':'topleft', \'show_ignored_files':1, \'buffer_name':'exlorer', \'toggle':1, \'resume':1, \})
option | 説明 |
---|---|
winwidth | ファイルエクスプローラの幅。30~50がお勧め |
split | horizontal (水平) or vertical (垂直) |
direction | ファイルエクスプローラの位置。topleft or botright |
show_ignored_files | いわゆるdotfilesを表示するかどうか。1 で表示。 |
buffer_name | バッファの名前 |
toggle | 1 にすれば、:Defx で、defxを開くだけでなく、閉じることもできるようになります。 |
resume | 1 にすれば、一度defxを閉じてからもう一度開いても、閉じる前の状態から始めることができます。 |
自動的に更新
defxのアクションで、ファイルを作成したり削除した時などは、もちろん即時に反映されます。しかし、この設定を加えることで、vimの外でファイルを削除したりした時なども反映されるようになります。
autocmd BufWritePost * call defx#redraw()
autocmd BufEnter * call defx#redraw()
autocmdを使って、バッファ保存時、またはバッファ移動時に再描画redraw()
をフックしています。ほんとはn秒に一回更新とかがいいけど...できるの?教えて誰か
アイコン
ここまでで、うまくいってればこんな感じになってると思います。(色は個人の設定によると思うので気にしないで)
十分かっこいいですが、さらに、IDEのようにファイル名の横にファイル種別ごとにアイコンを出すことができます。
フォントをインストール
Nerd Fontをbrewでインストールします。これはmacOS向けのインストールの方法です。他のOSの方はこちらを参照されたし。
brew tap homebrew/cask-fonts
brew cask install font-hack-nerd-font
Terminal側の設定
今更ですが、ターミナルはiTerm2の使用をお勧めします。iTerm2ではASCII FontとNon-ASCII Fontを別々で設定できるからです。
Non-ASCII Fontで、先ほどダウンロードしたフォントを選択しましょう。
macデフォルトのターミナルをどうしても使いたい方は、Fontをダウンロードしたものに変更してください。
defx-iconsとvim-deviconsをインストール
defx-iconsとvim-deviconsの2つのプラグインが必要です。
- dein
call dein#add('ryanoasis/vim-devicons')call dein#add('kristijanhusak/defx-icons')
- dein (toml)
[[plugins]]repo='ryanoasis/vim-devicons'[[plugins]]repo='kristijanhusak/defx-icons'
- vim-plug
Plug 'kristijanhusak/defx-icons'
Plug 'ryanoasis/vim-devicons'
インストールを実行することを忘れないでください
init.vimを調整
先ほどのcall defx#custom#option('_', {....
のブロックに,columns
のオプションを追加します。
このオプションを設定することで、defxのカラムに表示される情報を取捨選択したり、その順番を変更したりすことができます。今回は、左から、インデント(ディレクトリの階層を表現する)、ファイル種別ごとのアイコン、ファイル名、選択マークの順に表示することにします。
call defx#custom#option('_',{ \'winwidth':40, \'split':'vertical', \'direction':'topleft', \'show_ignored_files':1, \'buffer_name':'exproler', \'toggle':1, \'resume':1, \'columns':'indent:icons:filename:mark', \})
culomns
これでアイコンの設定が完了しました!vimを再起動すると、このように表示されているでしょうか?アイコンがかわいくて良い感じですね
gitのstatusを表示
gitで管理されているファイルのステータスをファイルツリーに表示するのは多くのIDEでは標準的な機能です。defxでもプラグインを用いれば可能です。
defx-gitをインストール
gitのステータスを表示するには、プラグインdefx-gitをインストールします。
- dein
call dein#add('kristijanhusak/git')
- dein (toml)
[[plugins]]repo='kristijanhusak/defx-git'
- vim-plug
Plug 'kristijanhusak/defx-git'
インストールを実行することを忘れないでください
init.vimを調整
先ほどと同様に、call defx#custom#option('_', {....
のブロックをいじります。columns
の、indent
とicons
の間にgit
を追加します。
call defx#custom#option('_',{ \'winwidth':40, \'split':'vertical', \'direction':'topleft', \'show_ignored_files':1, \'buffer_name':'exproler', \'toggle':1, \'resume':1, \'columns':'indent:git:icons:filename:mark', \})
次に、gitのステータスごとに表示されるアイコンを設定します。これもNERDフォントで指定できたらカッコいいですね。方法を知りたい。
call defx#custom#column('git','indicators',{ \'Modified':'✹', \'Staged':'✚', \'Untracked':'✭', \'Renamed':'➜', \'Unmerged':'═', \'Ignored':'☒', \'Deleted':'✖', \'Unknown':'?' \})
これで全ての設定が完了しました。vimを再起動し、gitで管理されているディレクトリに入って表示を確認してみます。このように表示されているでしょうか?
gitのアイコンが新しく表示されているのがわかると思います。いい感じですね!!
詞
- カスタマイズ性がすごいので、ドキュメントなどを読み込めばもっといろんなことができるようになると思います。
- めっちゃはやい!けど、アイコンを表示するとちょっと遅くなる...気がする?
- NERDフォント、普通にいいかんじなので、自分でいろんなところに使いたい。けど表示する方法がわかんない。教えて誰か...
- Shougoさん、いつも最高のプラグインをありがとうございます。
- 間違っている情報や古くなった情報などがあればご指摘お願いします。