Cara Menggunakan npm di Ubuntu: Panduan Instalasi, Perintah Dasar, dan Pemecahan Masalah

1. Pendahuluan

Mengapa Menggunakan npm di Ubuntu

Salah satu alat penting untuk pengembangan frontend maupun backend adalah npm (Node Package Manager). npm banyak digunakan sebagai alat manajemen paket untuk Node.js, memungkinkan pengembang dengan mudah menginstal dan mengelola pustaka serta alat JavaScript.

Dengan menggunakan npm di Ubuntu, Anda dapat memanfaatkan kinerja ringan Linux dan manajemen paket yang fleksibel sekaligus secara signifikan meningkatkan efisiensi pengembangan. Ubuntu adalah distribusi yang didukung oleh komunitas pengembang besar dan banyak dipakai untuk segala hal mulai dari operasi server hingga lingkungan pengembangan lokal.

Secara khusus, ketika bekerja dengan kerangka kerja berbasis Node.js seperti Vue.js, React, dan Next.js, mengelola paket dengan npm adalah pendekatan standar. Menyiapkan alat‑alat ini di Ubuntu memungkinkan Anda membangun lingkungan pengembangan yang stabil dengan lebih sedikit masalah dibandingkan Windows atau macOS.

Tujuan Artikel Ini

Artikel ini memberikan panduan langkah demi langkah untuk menginstal npm di Ubuntu dan menguasai penggunaan dasarnya. Artikel ini khusus ditujukan untuk audiens berikut:

• Pengembang yang baru mengenal Ubuntu
• Mereka yang mengalami kesulitan dengan pengaturan Node.js atau npm
• Siapa saja yang ingin belajar npm secara terstruktur

Berbagai metode instalasi diperkenalkan, lengkap dengan fitur, kelebihan, dan kekurangannya. Selain itu, panduan ini mencakup kesalahan umum, tips pemecahan masalah, dan perintah berguna untuk membantu pembaca menggunakan npm dengan lancar di Ubuntu.

2. Menginstal Node.js dan npm di Ubuntu

Untuk menggunakan npm di Ubuntu, Anda harus terlebih dahulu menginstal Node.js. Karena npm sudah termasuk dalam paket Node.js, menginstal Node.js secara otomatis menyediakan npm.

Berikut tiga metode utama untuk menginstal Node.js dan npm di Ubuntu. Setiap metode memiliki karakteristiknya masing‑masing, sehingga penting untuk memilih yang paling sesuai dengan gaya dan tujuan pengembangan Anda.

Metode 1: Menggunakan Repository Resmi Ubuntu

Langkah‑langkah

Node.js tersedia di repository standar Ubuntu. Ini adalah pendekatan paling sederhana dan ramah pemula.

sudo apt update
sudo apt install nodejs npm

Setelah instalasi, Anda dapat memeriksa versi dengan perintah berikut:

node -v
npm -v

Kelebihan

• Perintah sederhana yang mudah dipahami
• Versi stabil yang disediakan oleh Ubuntu

Kekurangan

• Versi Node.js dan npm sering kali usang, sehingga fitur terbaru mungkin tidak tersedia

Metode 2: Menggunakan NodeSource PPA

Dengan menggunakan repository NodeSource, yang mengikuti dukungan resmi Node.js secara dekat, Anda dapat menginstal versi Node.js dan npm yang lebih baru.

Langkah‑langkah (Contoh: Menginstal Node.js 18.x)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

npm secara otomatis terinstal bersama Node.js.

Kelebihan

• Akses ke versi yang relatif baru dan stabil
• Instalasi mudah dengan kompatibilitas Ubuntu yang baik

Kekurangan

• Seperti PPA lainnya, mungkin diperlukan manajemen dependensi

Metode 3: Menggunakan nvm (Node Version Manager)

Jika Anda ingin beralih antar beberapa versi Node.js, menggunakan nvm adalah opsi yang paling fleksibel dan kuat.

Langkah‑langkah

Pertama, instal nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Kemudian muat ulang shell Anda dan instal Node.js menggunakan nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm secara otomatis terinstal bersama Node.js.

Kelebihan

• Bebas beralih antar versi Node.js
• Menetapkan versi yang tepat per proyek
• Aman, karena tidak memengaruhi sistem secara global

Kekurangan

• Pengaturan sedikit lebih kompleks dibandingkan metode lain
• Memerlukan penyuntingan berkas konfigurasi shell

Metode Mana yang Harus Anda Pilih?

.Secara umum, nvm adalah opsi yang paling direkomendasikan untuk pengembangan npm jangka panjang di Ubuntu. Namun, jika Anda menginginkan penyiapan yang cepat dan sederhana, menggunakan NodeSource PPA juga merupakan pilihan yang solid.

3. Penggunaan Dasar npm

Setelah Node.js dan npm terpasang di Ubuntu, Anda dapat mulai mengelola paket dengan npm. npm adalah alat yang kuat untuk menginstal, memperbarui, dan menghapus paket JavaScript.

Bagian ini memperkenalkan perintah npm yang umum digunakan dan operasi dasar.

Menginstal Paket

Instalasi Lokal

Paket yang hanya digunakan dalam proyek tertentu harus diinstal secara lokal. Ini adalah pendekatan standar. Paket diinstal di direktori node_modules dan dicatat dalam package.json.

npm install package-name

Contoh: Menginstal axios

npm install axios

Hanya skrip dalam proyek yang sama yang dapat menggunakan paket yang diinstal secara lokal.

Instalasi Global

Alat yang digunakan secara sistem, seperti utilitas CLI, harus diinstal secara global.

npm install -g package-name

Contoh: Menginstal http-server secara global

sudo npm install -g http-server

Di Ubuntu, menggunakan -g mungkin memerlukan sudo.

Menghapus Paket

Menghapus Paket Lokal

npm uninstall package-name

Menghapus Paket Global

sudo npm uninstall -g package-name

Memperbarui Paket

Memperbarui Paket Tertentu

npm update package-name

Memperbarui Semua Dependensi

npm update

Pembaruan diterapkan dalam rentang versi yang ditentukan di package.json, jadi perhatikan batasan versi.

Menginstal Dependensi Pengembangan (–save-dev)

Paket yang hanya untuk pengembangan seperti alat pengujian atau build harus diinstal menggunakan opsi --save-dev.

npm install --save-dev package-name

Contoh: Menginstal jest sebagai dependensi pengembangan

npm install --save-dev jest

Ini mencatat paket di bawah devDependencies dalam package.json.

Menampilkan Paket yang Terinstal

Daftar Paket Lokal

npm list

Daftar Paket Global

npm list -g --depth=0

Menggunakan --depth=0 hanya menampilkan paket tingkat atas, membuat output lebih mudah dibaca.

Mengelola Dependensi dengan package.json

File package.json adalah komponen inti dari proyek berbasis npm. Ia mencatat nama paket, versi, skrip, dan konfigurasi proyek secara keseluruhan.

Anda dapat membuatnya menggunakan:

npm init

Untuk penyiapan sederhana dengan nilai default:

npm init -y

4. Masalah Umum dan Solusinya

Saat menggunakan npm di Ubuntu, Anda mungkin menemui kesalahan atau perilaku tak terduga. Bagian ini memperkenalkan masalah umum dan cara mengatasinya.

Kesalahan Izin

Gejala

EACCES: permission denied

Penyebab

Ini terjadi ketika pengguna saat ini tidak memiliki izin menulis untuk direktori tempat npm mencoba menginstal paket. Di Ubuntu, menulis ke direktori sistem seperti /usr/lib/node_modules memerlukan sudo.

Solusi

• Jalankan dengan sudo :

  sudo npm install -g package-name
  

• Atau ubah direktori instalasi global ke jalur yang dimiliki pengguna:

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Tambahkan berikut ke ~/.bashrc atau ~/.profile:

export PATH="$HOME/.npm-global/bin:$PATH"

Terapkan perubahan:

source ~/.bashrc

Perintah npm Tidak Ditemukan

Gejala

command not found: npm

Penyebab

• Instalasi Node.js atau npm gagal
• Variabel lingkungan PATH tidak dikonfigurasi

Solusi

Periksa jalur:

which npm

Jika tidak ada yang dikembalikan, instal ulang atau verifikasi pengaturan PATH. Jika menggunakan nvm, pastikan kode inisialisasi ada di file konfigurasi shell Anda:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Kegagalan Instalasi Paket atau Konflik Versi

Gejala

• Konflik versi saat menginstal paket
• Banyak peringatan selama npm install

Solusi

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Perintah Debugging yang Berguna

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Pertanyaan yang Sering Diajukan (FAQ)

P1. Bagaimana cara memperbarui npm ke versi terbaru di Ubuntu?

J1.

sudo npm install -g npm@latest

Jika Anda menggunakan nvm, sudo tidak diperlukan.

P2. Apa perbedaan antara instalasi global dan lokal?

J2.

• Instalasi Lokal : Dependensi spesifik proyek yang disimpan di node_modules
• Instalasi Global : Alat CLI sistem-wide, sering kali memerlukan sudo

P3. Apa manfaat menggunakan nvm?

J3.

nvm memungkinkan Anda beralih antara beberapa versi Node.js dengan aman dan efisien, menjadikannya ideal untuk pengembangan multi-proyek.

P4. Apa yang harus saya lakukan jika dependensi npm rusak?

J4.

rm -rf node_modules package-lock.json
npm install

P5. Apakah pesan npm WARN dan audit menjadi masalah?

J5.

Peringatan tidak fatal tetapi menunjukkan potensi masalah. Untuk peringatan terkait keamanan, Anda bisa mencoba:

npm audit fix

P6. Apa yang bisa saya bangun dengan npm di Ubuntu?

J6.

• Kerangka frontend (React, Vue, Svelte)
• Generator situs statis (Next.js, Nuxt)
• Aplikasi backend (Express, NestJS)
• Alat CLI
• Lingkungan pengujian

6. Kesimpulan: Kuasai npm di Ubuntu

Artikel ini membahas dasar-dasar instalasi dan penggunaan npm di Ubuntu, mulai dari pengaturan hingga pemecahan masalah.

Langkah terpenting adalah bereksperimen secara langsung. Dengan menjalankan perintah dan memahami pesan kesalahan, Anda akan secara bertahap mendalami keterampilan Anda sebagai pengembang.

Ini menyimpulkan panduan lengkap untuk menggunakan npm di Ubuntu. Kami harap ini membantu Anda membangun lingkungan pengembangan yang lebih efisien dan kuat.