KAL
Menu

Penyiapan

Memasang Nim 2.4 menggunakan choosenim dan menyiapkan editor beserta dukungannya.

Daftar isi

Compiler Nim tersedia untuk Linux, macOS, dan Windows, dan cara pemasangan yang disarankan adalah melalui choosenim, yaitu penginstal resmi yang sekaligus mengelola lebih dari satu versi Nim. Topik ini menunjukkan perintah pemasangan untuk setiap sistem operasi, verifikasi hasilnya melalui nim --version dan nimble --version, serta penyiapan editor VS Code beserta dukungan pemeriksaan kodenya. Verifikasi dilakukan di sandbox yang sudah menjalankan compiler resmi Nim 2.4.0.

Memasang choosenim#

Choosenim memasang Nim dari unduhan resmi nim-lang.org dan mengelola beberapa versi dalam satu mesin, sehingga versi yang aktif dapat ditukar kapan pun. Pemasangan pada Linux dan macOS dilakukan dengan satu perintah:

bash 
# tidak-dijalankan
# memasang choosenim pada Linux dan macOS, membutuhkan koneksi internet
curl https://nim-lang.org/choosenim/init.sh -sSf | sh

Perintah tersebut mengunduh skrip pemasangan, memilih kanal stable, lalu memasang compiler beserta alat pendampingnya seperti nimble, nimsuggest, nimpretty, dan testament. Prosesnya memerlukan koneksi internet, sehingga perintah ini tidak dijalankan di sandbox dan keluarannya tidak ditampilkan. Setelah selesai, compiler siap digunakan tanpa langkah konfigurasi tambahan selain pengaturan PATH di bawah ini.

Pada Windows, choosenim dipasang dengan mengunduh berkas zip dari halaman rilisnya di GitHub, mengekstrak arsip tersebut, kemudian menjalankan skrip runme.bat yang menyertainya. Penginstal menampilkan serangkaian pertanyaan pada layar, misalnya pilihan versi awal, lalu menyelesaikan pemasangan Nim beserta choosenim itu sendiri. Setelah proses selesai, perintah nim dapat dipanggil dari jendela terminal yang baru dibuka.

Memilih kanal dan versi#

Choosenim mengatur versi Nim melalui kanal (channel), yaitu jalur pembaruan yang menunjuk kelompok versi tertentu. Kanal stable berisi rilis stabil terkini, sedangkan kanal devel berisi versi pengembangan yang memuat perubahan terbaru. Perintah pemasangan pada bagian sebelumnya mengikuti kanal stable secara bawaan, sehingga versi yang terpasang adalah rilis stabil terbaru, yakni 2.4.0 pada saat jalur ini ditulis.

Pergantian versi dilakukan dengan perintah choosenim diikuti nama kanal atau nomor versi. Kanal menentukan apa yang diunduh choosenim, sedangkan nomor tertentu tetap dapat dipilih bila proyek menuntut versi lama, misalnya choosenim 1.6.6. Perintah berikut memasang rilis stabil terkini, atau beralih ke versi tersebut bila sudah pernah terpasang:

bash 
# tidak-dijalankan
# memilih kanal stable agar versi terpasang adalah rilis stabil terkini, membutuhkan koneksi internet
choosenim stable

Pembaruan ke rilis stabil berikutnya menggunakan choosenim update stable, sedangkan choosenim show menampilkan versi aktif beserta daftar versi yang tersimpan secara lokal. Mekanisme ini memungkinkan satu mesin menyimpan beberapa versi Nim sekaligus, sehingga proyek lama tetap dapat dibangun dengan versi yang sesuai. Kebutuhan seperti itu lazim pada pemeliharaan proyek yang berumur panjang.

Memverifikasi hasil pemasangan#

Hasil pemasangan diverifikasi dengan memanggil compiler dan pengelola paketnya langsung dari terminal. Perintah nim --version menampilkan versi compiler yang sedang aktif:

bash 
# memeriksa versi compiler Nim yang terpasang
nim --version
text Keluaran 
Nim Compiler Version 2.4.0 [Linux: amd64]
Compiled at 2026-10-28
Copyright (c) 2006-2026 by Andreas Rumpf

git hash: 14991af742d0833503741fd9a0918133d1bcf8a4
active boot switches: -d:release

Baris pertama menyebut versi compiler dan platformnya, yaitu 2.4.0 untuk Linux amd64 pada sandbox ini. Baris Compiled at menunjukkan tanggal biner compiler dibangun, sedangkan git hash menunjuk kode sumber yang menjadi asal biner tersebut. Pada sistem operasi lain, bagian platform berubah, misalnya menjadi Windows amd64, tetapi nomor versinya tetap sama.

Pengelola paket nimble terpasang bersama compiler, dan versinya diperiksa dengan cara yang sama:

bash 
# memeriksa versi nimble yang menyertai compiler
nimble --version
text Keluaran 
nimble v0.26.2 compiled at 2026-10-28 05:49:14
git hash: couldn't determine git hash

Keluaran menunjukkan nimble versi 0.26.2 yang dikompilasi bersama compiler 2.4.0 pada 28 Oktober 2026. Pesan couldn't determine git hash bukan tanda error, melainkan tanda bahwa biner nimble ini dibangun tanpa metadata git. Kedua perintah tersebut tidak memerlukan koneksi internet, sehingga aman dijalankan kapan pun sebagai pemeriksaan cepat. Apabila versi yang muncul berbeda dari yang diharapkan, choosenim show membantu menelusuri versi yang sedang aktif beserta kanalnya.

Menyiapkan editor#

Editor menemani hampir seluruh pekerjaan pemrograman, dan dukungan Nim pada editor berpangkal pada nimsuggest, yaitu alat bawaan Nim yang menjawab pertanyaan editor mengenai berkas .nim. Melalui nimsuggest, editor memperoleh daftar pelengkapan simbol, definisi sebuah simbol, dan daftar tempat simbol tersebut digunakan. Dokumentasi resmi menyebut nimsuggest sebagai frontend untuk nim compiler, sehingga kualitas saran yang diberikannya mengikuti pemahaman compiler terhadap kode.

Untuk Visual Studio Code, dukungan disediakan ekstensi resmi nim-lang.org yang diterbitkan tim compiler Nim. Ekstensi tersebut menyediakan penyorotan sintaks untuk berkas .nim, .nimble, dan .nim.cfg, pelengkapan kode, navigasi goto definition, pencarian referensi, serta pemeriksaan kode saat berkas disimpan. Pelengkap kodenya ditangani Nim Language Server, sedangkan proses nimsuggest dapat dijalankan ulang dari panel perintah bila hasil analisisnya terasa tertinggal.

Penyiapannya terdiri atas tiga langkah:

  1. Pasang Visual Studio Code.
  2. Buka panel Extensions, cari nim-lang.org, lalu tekan tombol Install.
  3. Buka folder proyek yang memuat berkas .nim dan biarkan ekstensi menyiapkan layanannya.

Integrasi untuk editor lain tersedia melalui plugin komunitas, dan nimsuggest tetap menjadi dasar yang sama di balik fitur pelengkap dan navigasinya. Dengan begitu, perilaku saran kode relatif konsisten antar editor, sedangkan pilihan editor kembali ke kebiasaan masing-masing pengembang.

Kesalahan umum#

Dua kesalahan yang paling lazim saat menyiapkan Nim berada di sekitar PATH dan pilihan versi. Keduanya mudah dikenali dari pesannya, dan perbaikannya tidak menuntut pemasangan ulang.

  1. Terminal menampilkan command not found setelah pemasangan selesai. Penyebabnya adalah direktori ~/.nimble/bin belum terdaftar di PATH, atau terminal masih menggunakan sesi yang dibuka sebelum pemasangan. Tambahkan baris export PATH="$HOME/.nimble/bin:$PATH" ke berkas konfigurasi shell yang digunakan, lalu buka terminal baru dan panggil ulang nim --version sebagai pemeriksaannya.
  2. Pemasangan versi devel berjalan lama atau terasa berhenti. Memilih versi dari cabang pengembangan menuntut git terpasang, dan compiler dapat dibangun ulang dari sumbernya (bootstrap), proses yang memang jauh lebih lambat daripada mengunduh biner siap pakai. Pemasangan melalui kanal stable menghindari kedua hal tersebut, sehingga menjadi pilihan yang tepat untuk lingkungan kerja pertama.

Kedua perbaikan di atas tidak mengulang proses pemasangan, karena choosenim tetap menggunakan unduhan yang sudah tersimpan. Pemeriksaan ulang cukup dilakukan dengan choosenim show dan nim --version.

Ringkasan#

  • Choosenim memasang Nim dari unduhan resmi dan mengelola beberapa versi melalui kanal stable dan devel.
  • Pemasangan Linux dan macOS berupa satu perintah curl, sedangkan Windows menggunakan arsip zip beserta skrip runme.bat.
  • nim --version dan nimble --version mengonfirmasi compiler 2.4.0 beserta nimble 0.26.2 pada sandbox ini.
  • Direktori ~/.nimble/bin wajib berada di PATH, dan dukungan editor VS Code disediakan ekstensi resmi yang bertumpu pada nimsuggest.

Referensi#