Belajar Neovim - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar Neovim! Series ini akan mengajak kalian menguasai Neovim dari nol hingga level siap produksi: mulai dari filosofi modal editing, Vim motion, navigasi cepat, registers & macros, konfigurasi Lua (init.lua), plugin manager lazy.nvim, Treesitter, LSP, autocompletion, hingga arsitektur setup production-grade di episode-episode berikutnya. Total ada 28 episode yang akan menuntun kalian membangun editor ultra-cepat sebagai daily driver.

Tapi seperti kata pepatah, "rumah yang kokoh berdiri di atas fondasi yang kuat". Sebelum menekan tombol d untuk menghapus teks atau menulis konfigurasi Lua pertama, ada beberapa skill dasar dan tools yang wajib kalian miliki dan siapkan terlebih dahulu.

Mengapa prasyarat ini begitu penting? Neovim adalah editor yang berjalan di dalam terminal dan dikonfigurasi menggunakan Lua. Ia bukan aplikasi GUI dengan tombol-tombol yang bisa diklik — semuanya terjadi lewat keyboard, command, dan file konfigurasi teks. Artinya, jika kalian belum nyaman dengan terminal CLI atau belum paham bagaimana teks dan file bekerja di level sistem, perjalanan belajar kalian akan tersendat di setiap langkah. Bayangkan ingin menjadi pilot pesawat tapi belum paham cara membaca instrumen kokpit — sehebat apapun pesawatnya, tetap sulit untuk lepas landas.

Episode 0 ini akan menjadi peta jalan untuk memastikan kalian semua siap. Kita akan membahas skill fundamental yang dibutuhkan, menyiapkan seluruh perangkat lunak (Neovim, terminal modern, Nerd Font, dan tooling pendukung), lalu menutup dengan verifikasi bahwa semuanya berjalan dengan baik. Setelah episode ini selesai, kalian sudah benar-benar siap melangkah ke episode 1 yang membahas sejarah dan latar belakang mengapa Neovim ada.

#Skill Dasar yang Wajib Dimiliki

Kita mulai dari skill. Tanpa skill ini, setup tools secanggih apapun tidak akan berguna.

#Dasar Terminal & CLI

Neovim lahir dan tumbuh besar di ekosistem Linux/Unix, dan ia hidup di dalam terminal. Meskipun bisa dijalankan di Windows (native maupun WSL2), mayoritas penggunaannya di dunia nyata — termasuk di server dan CI/CD — berjalan di atas Linux. Karena itu, kemampuan mengoperasikan CLI adalah syarat mutlak.

Apa saja yang harus kalian kuasai?

1. Navigasi & manajemen file. Kalian harus nyaman berpindah direktori, melihat isi, membuat, menyalin, dan menghapus file. Kemampuan ini akan kalian pakai setiap hari, termasuk saat mengelola direktori konfigurasi ~/.config/nvim/.

Navigasi & manajemen file

pwd                        # cetak direktori kerja saat ini
ls -la                     # lihat isi direktori (termasuk hidden file)
cd ~/.config/nvim          # pindah ke direktori konfigurasi Neovim
mkdir -p lua/config        # buat direktori bertingkat
cp init.lua backup/init.lua # salin file

2. Membaca dan memproses teks. Neovim bekerja dengan file teks biasa, dan saat debugging kita sering harus menyaring output log yang panjang. Kalian perlu mengenal perintah seperti cat, less, grep, dan sed.

3. Konsep PATH & environment variable. Saat kalian menjalankan nvim di terminal, shell mencari binary tersebut di direktori yang terdaftar di $PATH. Jika nvim tidak ditemukan (error command not found), kemungkinan besar binary-nya belum masuk ke PATH. Paham $PATH akan menyelamatkan kalian dari salah satu kesalahan paling umum di episode ini.

4. Paket manager. Kalian harus bisa menginstall software lewat paket manager distro masing-masing, karena inilah cara paling mudah memasang Neovim. Di Ubuntu/Debian menggunakan apt, di Fedora/RHEL menggunakan dnf, di Arch menggunakan pacman, dan di macOS menggunakan brew.

#Konsep Dasar Text Editing

Neovim adalah text editor, jadi paham cara teks direpresentasikan di komputer adalah fondasi penting. Beberapa konsep yang perlu kalian pahami:

Kenapa ini penting? Karena semua yang akan kalian lakukan di Neovim — menghapus baris, melompat ke kata berikutnya, mencari pola — pada dasarnya adalah manipulasi posisi kursor terhadap teks. Memahami bahwa file adalah kumpulan baris dan karakter akan membuat semua konsep motion di episode 2 terasa intuitif.

#Perangkat Software & Tools yang Disiapkan

Kebutuhan hardware Neovim sangat sederhana — cukup laptop biasa. Berikut daftar lengkap perangkat yang akan kita siapkan di episode ini:

#Instalasi Neovim (v0.10+)

#Linux

Di Linux, cara paling mudah adalah lewat paket manager. Pastikan versi yang didapat minimal 0.10.0. Di beberapa distro (misalnya Debian stable), versi Neovim di repositori resmi bisa tertinggal — jika kalian butuh versi terbaru, gunakan AppImage, binary release, atau paket dari maintainer komunitas.

Ubuntu/Debian (apt)Fedora/RHEL (dnf)Arch (pacman)

sudo apt update && sudo apt install -y neovim

sudo dnf install -y neovim

sudo pacman -S neovim

#macOS

brew update
brew install neovim

#Windows

choco install neovim

scoop install neovim

#Verifikasi Instalasi

Setelah terinstall, verifikasi versinya. Pastikan minimal NVIM v0.10.0:

nvim --version
 
NVIM v0.11.0
Build type: Release
...

Jika versi kalian lebih lama dari 0.10.0, upgrade dulu sebelum melanjutkan series ini.

#Terminal Modern dengan True Color

Neovim adalah editor di dalam terminal — artinya, kualitas tampilannya sangat bergantung pada terminal yang kalian pakai. Terminal modern yang mendukung true color (24-bit) akan membuat colorscheme Neovim tampil sempurna. Terminal lama yang hanya mendukung 256 warna akan membuat warna terlihat "pudar" (posterized) dan tidak enak dilihat.

Rekomendasi terminal modern:

#Instalasi Nerd Font

Nerd Font adalah font yang dipatch dengan ribuan glyph/icon (chevron, folder, git, logo bahasa pemrograman) yang dibutuhkan plugin modern seperti nvim-web-devicons, lualine.nvim, dan bufferline.nvim. Tanpa Nerd Font, icon tersebut tampil sebagai kotak kosong (tofu).

#Menginstall Nerd Font

Rekomendasi: JetBrainsMono Nerd Font, FiraCode Nerd Font, atau Hack Nerd Font. Cara paling mudah adalah mengunduh dari situs resmi Nerd Fonts:

Install JetBrainsMono Nerd Font (Linux)

mkdir -p ~/.local/share/fonts
wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.1/JetBrainsMono.zip
unzip JetBrainsMono.zip -d ~/.local/share/fonts
fc-cache -fv ~/.local/share/fonts

Konfirmasi font terpasang

fc-list | grep -i "JetBrainsMono"

Setelah font terpasang, atur font tersebut di settings terminal kalian (bukan di Neovim). Di Ghostty misalnya:

font-family = JetBrainsMono Nerd Font
font-size = 13

#Tooling Pendukung

Neovim sendiri hanyalah editor — kekuatan penuhnya datang dari ekosistem tools di sekitarnya. Beberapa tools wajib/rekomendasi:

Install tooling (Ubuntu/Debian)

sudo apt install -y git make build-essential ripgrep fd-find unzip curl
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs

#Verifikasi Pertama: Menjalankan Neovim

Setelah semuanya terpasang, saatnya uji coba pertama. Jalankan nvim di terminal:

nvim
 
# Di dalam Neovim, cek kesehatan:
:checkhealth

Saat pertama kali dibuka, Neovim menampilkan layar kosong dengan teks bantuan. Jangan khawatir jika terlihat "sepi" — itu memang desainnya. Neovim default memang hampir tanpa hiasan; di fase-fase berikutnya kita akan membangun tampilan modern lewat konfigurasi Lua.

Beberapa hal yang perlu diverifikasi:

1. Neovim terbuka di dalam terminal — tidak memunculkan window baru terpisah.
2. Teks bantuan tampil benar — tidak ada karakter aneh/kotak (jika ada, berarti font terminal belum Nerd Font).
3. Warna tampil halus — cek dengan perintah berikut:

:set termguicolors
:hi Normal guibg=#1e1e2e guifg=#cdd6f4

Jika background berubah menjadi biru-abu gelap (Catppuccin Mocha) dengan teks terang tanpa "pita" warna kasar, maka true color kalian bekerja dengan baik.

#Kesalahan Umum (Common Pitfalls)

Berikut kesalahan paling sering dialami pemula saat setup:

1. Versi Neovim terlalu lama. Banyak yang menginstall dari repositori distro lama (misal Debian stable) dan mendapat Neovim 0.7/0.8. Akibatnya plugin terbaru gagal. Solusi: pastikan nvim --version menunjukkan minimal 0.10.0.

2. Terminal tidak mendukung true color. Colorscheme tampak "pudar" atau warna terlihat aneh. Solusi: gunakan terminal modern (WezTerm, Kitty, Ghostty, Alacritty), bukan terminal bawaan yang kuno.

3. Font terminal tidak diganti ke Nerd Font. Icon plugin tampil sebagai kotak kosong (□). Solusi: install Nerd Font dan ganti font di settings terminal, lalu restart terminal.

4. command not found: nvim. Binary tidak ditemukan di $PATH. Solusi: cek lokasi install, tambahkan ke PATH di shell config (~/.bashrc/~/.zshrc), lalu source ulang atau buka terminal baru.

5. Neovim berjalan lambat di WSL2. Folder project berada di path Windows (/mnt/c/...) yang I/O-nya lambat. Solusi: simpan project di file system Linux (~/...), bukan di /mnt/c.

6. Mencoba mempelajari semua sekaligus. Neovim terasa "tidak nyaman" di minggu pertama — itu normal. Jangan buru-buru memasang 50 plugin sebelum paham dasar modal editing.

#Penutup

Di episode 0 ini kita sudah menyiapkan pijakan yang kokoh: menguasai dua skill fundamental (terminal CLI dan konsep text editing), menginstall Neovim v0.10+, menyiapkan terminal modern dengan true color, memasang Nerd Font, dan melengkapi tooling pendukung seperti git, make, gcc, ripgrep, fd, npm, dan python3. Kita juga sudah memverifikasi bahwa Neovim bisa berjalan dengan baik di terminal kalian.

Poin penting yang harus kalian bawa:

• Neovim hidup di dalam terminal — kuasai dasar CLI dan $PATH.
• Neovim adalah text editor murni — semua operasi berbasis posisi kursor dan pola teks.
• Pastikan Neovim v0.10+, terminal dengan true color, dan Nerd Font terpasang dengan benar.
• Siapkan tooling pendukung (git, make, gcc, rg, fd) karena akan dipakai di fase plugin.
• Kesalahan setup paling umum adalah versi lama, font salah, dan PATH salah — cek ketiganya dulu jika ada masalah.

Pastikan seluruh tools di atas sudah siap, karena episode berikutnya akan membahas konsep. Di episode 1 selanjutnya, kita akan membahas sejarah, latar belakang, dan mengapa memilih Neovim — mulai dari evolusi Vi (1976) → Vim (1991) → Neovim (2014), keunggulan arsitektur Neovim yang refactored, hingga filosofi modal editing yang mengubah cara kalian menulis kode. Pastikan tetap semangat, karena perjalanan belajar Neovim baru saja dimulai!