Belajar Neovim - File Explorer & Buffer-based Navigation (neo-tree / oil.nvim)

#Pendahuluan

Setelah di episode 11 sebelumnya kita membangun navigasi super cepat dengan telescope.nvim, ada satu pertanyaan yang sering muncul di benak pengguna baru Neovim: "Kalau sudah bisa cari file dalam sepersekian detik, untuk apa masih butuh file explorer?" Jawabannya: karena fuzzy finder hanya membantu jika kalian sudah tahu nama filenya.

Bayangkan kalian baru bergabung ke codebase orang lain. Kalian membuka repo, lalu apa? Telescope find_files menuntut kalian mengetik sesuatu. Tapi untuk memahami struktur proyek — "apa saja file di direktori services/, modul apa yang saling bergantung, file mana yang baru saya buat?" — kalian butuh melihat peta direktori secara visual. Di dunia nyata, ini persis seperti perbedaan antara mencari nama kontak di telepon (fuzzy finder) versus melihat daftar folder di rak arsip (file explorer): keduanya saling melengkapi, bukan saling menggantikan.

Di episode 12 ini kita akan membahas dua pendekatan: neo-tree.nvim sebagai file explorer visual modern, dan oil.nvim yang menawarkan paradigma radikal — mengedit direktori seperti mengedit file teks biasa. Mari kita mulai.

#Pembahasan Utama

#Netrw: File Explorer Bawaan yang Harus Digantikan

Fakta yang jarang diketahui: Neovim sebenarnya sudah punya file explorer bawaan bernama netrw (dipanggil lewat :Explore, :e ., atau :Ex). Sayangnya, netrw terasa kuno — navigasinya membingungkan, tidak ada ikon file, dan tabrakan keymap-nya sering mengganggu plugin lain.

Sebagian besar user modern menggantinya dengan neo-tree.nvim atau nvim-tree.lua. Dan yang terpenting: netrw harus dimatikan agar tidak bentrok dengan explorer pilihan kita. Caranya lewat satu blok vim.g di config:

vim.g.loaded_netrw = 1
vim.g.loaded_netrwPlugin = 1

#neo-tree.nvim: File Explorer Visual Modern

neo-tree.nvim adalah file explorer yang memisahkan sumber (source) menjadi tiga panel: filesystem, buffers, dan git_status. Ini berbeda dari kebanyakan explorer lain yang menggabungkan semuanya dalam satu view. Ia juga punya file watcher berbasis libuv — perubahan file di luar editor langsung tercermin di tree tanpa refresh manual.

return {
  {
    "nvim-neo-tree/neo-tree.nvim",
    cmd = "Neotree",
    keys = {
      { "<leader>e", "<cmd>Neotree toggle<CR>", desc = "Toggle file explorer" },
      { "<leader>E", "<cmd>Neotree focus<CR>", desc = "Fokus ke file explorer" },
    },
    dependencies = {
      "nvim-lua/plenary.nvim",
      "MunifTanjim/nui.nvim",
      "nvim-tree/nvim-web-devicons",
    },
    opts = {
      close_if_last_window = true,
      filesystem = {
        follow_current_file = { enabled = true },
        use_libuv_file_watcher = true,
      },
    },
  },
}

Dua setting kunci yang perlu dipahami:

• follow_current_file = true — setiap kali kalian pindah ke file lain, neo-tree otomatis menyorot file itu di dalam tree. Ini membuat "di mana saya sekarang?" selalu terjawab. Sangat berguna di proyek besar.
• use_libuv_file_watcher = true — memakai file watcher bawaan sistem. Kalau teman kalian mengubah file di editor lain, perubahan langsung terlihat di tree kalian.

Keymap navigasi penting di neo-tree:

#Operasi File: Create, Rename, Delete & Move

Nilai jual utama file explorer dibanding fuzzy finder adalah operasi file visual: membuat, mengganti nama, menghapus, dan memindahkan file tanpa keluar dari editor. Neo-tree menyediakan semua itu melalui mapping default pada file yang disorot:

Contoh alur kerja nyata: kalian ingin membuat file lua/plugins/dap.lua untuk episode 22 nanti. Buka neo-tree (<leader>e), navigasi ke folder lua/plugins/ dengan j/k dan l, tekan a, ketik dap.lua, tekan Enter. File langsung muncul di tree dan siap diedit.

Keseluruhan operasi di atas juga bisa dilakukan via command line tanpa explorer, jika kalian lebih suka:

:Neotree reveal            " buka explorer dan sorot file aktif
:Neotree toggle filesystem " toggle panel filesystem saja

Satu catatan penting soal operasi file: semuanya adalah perubahan sistem file secara langsung — tidak ada undo di dalam explorer. Neo-tree memberikan konfirmasi untuk operasi berisiko (d untuk delete), tapi membiasakan diri dengan keymap sebelum menggunakannya di file penting adalah kebiasaan yang baik.

#Source Lain di neo-tree: Buffers & Git Status

Sebagaimana disebut di awal, neo-tree punya tiga source terpisah. Menguasai dua lainnya akan membuat kalian jarang kembali ke telescope untuk melihat status git:

Untuk berpindah antar source, cukup tekan H / L di dalam window neo-tree (mengikuti logika "kiri/kanan" yang konsisten dengan Vim motion). Source git_status sangat berguna untuk memilah pekerjaan: file untracked, modified, dan deleted dikelompokkan secara visual, dan menekan o pada sebuah file langsung membuka diff-nya.

#nvim-tree.lua: Alternatif yang Lebih Sederhana

Sebelum neo-tree, eksplorasi file di Neovim identik dengan nvim-tree.lua — plugin yang lebih ringan, fokus satu source (filesystem saja), dan tidak bergantung pada nui.nvim. Banyak distro (NvChad, misalnya) masih memakainya sebagai default karena simpel:

return {
  "nvim-tree/nvim-tree.lua",
  dependencies = { "nvim-tree/nvim-web-devicons" },
  keys = {
    { "<leader>e", "<cmd>NvimTreeToggle<CR>", desc = "Toggle file explorer" },
  },
  opts = {
    view = { width = 34 },
    update_cwd = true,
  },
}

Bagaimana memilih di antara keduanya? Pertimbangannya:

• Pilih neo-tree jika kalian menginginkan sumber git dan buffers dalam satu explorer, file watcher real-time, dan tampilan yang lebih kaya (ikon custom, indent expander).
• Pilih nvim-tree jika kalian hanya butuh tree filesystem yang stabil, cepat, dan minim dependency. Lebih sedikit fitur berarti lebih sedikit hal yang bisa rusak.

#Studi Kasus: Alur Kerja Explorer + Fuzzy Finder

Mari kita rangkai semuanya dalam satu skenario kerja nyata. Kalian menerima task untuk menambahkan endpoint baru GET /health di service Go yang belum pernah kalian buka sebelumnya:

1. Buka proyek, tekan <leader>e — neo-tree menampilkan struktur. Jelajahi folder internal/api/ untuk memahami pola handler yang sudah ada.
2. Kalian menemukan handler.go. Tekan v untuk membukanya di split vertikal, lalu l untuk memperluas struktur folder di sekitarnya.
3. Ingin melihat file yang baru saja diubah sebelum kalian mulai? Tekan H untuk pindah ke source git_status — semua perubahan terlihat.
4. Saat menulis kode, cari referensi helper dengan <leader>fg — telescope live_grep mengambil alih.
5. Saat selesai, buat file test baru: kembali ke filesystem (tekan L), sorot folder internal/api/, tekan a, ketik handler_test.go.

Perhatikan alurnya: explorer untuk menjelajah dan memahami, git status untuk mengawasi perubahan, fuzzy finder untuk menemukan sesuatu yang spesifik. Tiga alat, satu tujuan, tanpa satu pun klik mouse.

#oil.nvim: Mengedit Direktori Seperti Mengedit File

Sekarang mari kita bahas pendekatan yang benar-benar berbeda. oil.nvim (Oil = "Open In Lover" — parafrase dari konsep edit directory like a file) tidak menggambar tree. Ia menampilkan isi direktori sebagai buffer teks biasa — sebuah file dengan satu baris per entry. Kalian mengeditnya seperti mengedit teks: ubah nama, hapus baris, tambahkan baris, lalu simpan dengan :w dan perubahan akan diterapkan ke sistem file nyata.

return {
  {
    "stevearc/oil.nvim",
    keys = {
      { "-", "<cmd>Oil<CR>", desc = "Buka oil (direktori parent)" },
      { "<leader>-", "<cmd>Oil<CR>", desc = "Buka oil dari file aktif" },
    },
    opts = {
      default_file_explorer = true,
      columns = { "icon" },
      delete_to_trash = false,
      view_options = {
        show_hidden = true,
      },
    },
  },
}

Berikut contoh bagaimana tampilan buffer oil:

..            ../                    " naik satu level
.github/      .github/
.vscode/      .vscode/
config/       config/
content/      content/
package.json  package.json
README.md     README.md
src/          src/
tsconfig.json tsconfig.json

Cara kerja oil:

1. Buka oil dengan - — buffer berisi daftar entry direktori.
2. Edit langsung: rename README.md menjadi README-old.md, atau hapus barisnya (delete) — seperti mengedit teks biasa.
3. Tekan :w — oil menerapkan seluruh perubahan sekaligus ke sistem file.
4. Tekan - lagi untuk naik ke parent directory.

Oil juga punya preview bawaan: arahkan kursor ke sebuah file dan oil menampilkan isinya di window preview — membantu memutuskan "apakah ini file yang saya cari?" tanpa membukanya.

Salah satu opsi oil yang layak dipertimbangkan adalah delete_to_trash — mengirim file yang "dihapus" ke trash system alih-alih menghapus permanen. Ini jaring pengaman yang murah untuk kesalahan yang tidak bisa di-undo:

    opts = {
      default_file_explorer = true,
      columns = { "icon" },
# [!code --:1]
      delete_to_trash = false,
# [!code ++:1]
      delete_to_trash = true,
      view_options = {
        show_hidden = true,
      },
    },

#Explorer vs Fuzzy Finder: Kapan Memakai yang Mana?

Setelah punya telescope, neo-tree, dan oil, kalian punya tiga alat untuk satu tujuan: membuka file. Kunci efisiensi adalah tahu kapan memakai masing-masing:

#Kesalahan Umum File Explorer & Oil

#Penutup

Pada episode 12 ini kita telah menambahkan dua senjata navigasi yang saling melengkapi: neo-tree.nvim sebagai file explorer visual dengan operasi file lengkap (create, rename, delete, move, copy-paste) dan file watcher real-time, serta oil.nvim yang mengedit direktori seperti mengedit teks biasa dengan :w sebagai tombol apply. Kalian juga sekarang tahu kapan harus memakai explorer, kapan fuzzy finder, dan kapan oil — berdasarkan konteks pekerjaan, bukan kebiasaan.

Hingga titik ini, kalian bisa membuka file apa pun di proyek secepat kilat. Tapi bagaimana dengan berpindah ke file yang sama berulang kali dalam satu sesi kerja? Atau membangun kembali seluruh layout window setelah laptop direstart? Di episode 13 selanjutnya kita akan membahas jump navigation super cepat dengan flash.nvim, penanda file favorit dengan harpoon, serta session management dan undo tree — level berikutnya dari produktivitas editing. Pastikan tetap semangat!