Cara Mengaktifkan dan Menggunakan npm (Pengurus Pakej Node.js) dalam ServBay

npm (Node Package Manager) ialah alat pengurusan pakej rasmi untuk Node.js dan juga salah satu repositori perisian sumber terbuka terbesar di dunia. Bagi pembangun Node.js, npm merupakan alat yang tidak dapat digantikan kerana ia memudahkan pemasangan, perkongsian, dan pengurusan kebergantungan kod dalam projek anda. Dengan persekitaran terintegrasi ServBay, anda boleh mula menggunakan npm untuk pembangunan dengan cepat.

Prasyarat

Sebelum menggunakan npm, anda perlu memasang Node.js melalui ServBay.

1. Buka aplikasi ServBay.
2. Navigasi ke panel "Perisian" (Packages).
3. Cari pakej Node.js dan pastikan ia telah dipasang serta sedang berjalan.

ServBay akan mengkonfigurasi persekitaran Node.js secara automatik, termasuk npm.

Sahkan npm Telah Dipasang dan Boleh Digunakan

Node.js yang dipasang melalui ServBay sudah tersedia dengan npm dan ia diaktifkan secara lalai. Anda boleh mengesahkan sama ada npm telah dipasang dan boleh diakses melalui terminal.

1. Buka aplikasi terminal anda (seperti Terminal pada macOS).

2. Taip arahan berikut untuk melihat versi npm:

   npm -v

   Jika arahan berjaya dan memaparkan nombor versi (seperti 10.2.0 atau lebih tinggi), bermakna npm telah dipasang dengan betul dan boleh digunakan dalam persekitaran anda.

   # Contoh output
   10.2.0

   Jika anda melihat ralat seperti "command not found: npm", pastikan anda telah memasang pakej Node.js menerusi ServBay dan pembolehubah persekitaran (environment variable) ServBay telah dimuatkan dengan betul (biasanya masalah ini dapat diselesaikan dengan memulakan semula terminal atau komputer anda).

Kemas Kini npm

Walaupun versi Node.js yang dipasang melalui ServBay biasanya termasuk versi stabil npm, npm sendiri sering dikemas kini secara berasingan daripada Node.js. Untuk mendapatkan ciri dan pembaikan terbaru, anda boleh mengemas kini npm secara tersendiri:

npm install -g npm@latest

Arahan ini akan memasang versi terbaru npm secara global. Flag -g bermaksud pemasangan global supaya anda boleh menggunakan perintah npm terbaru di mana-mana sahaja.

Selepas kemas kini selesai, jalankan semula npm -v untuk mengesahkan versi semasa:

npm -v

Fungsi Teras & Penggunaan Biasa npm

Kekuatan npm terletak pada ekosistem sumber terbuka yang luas serta keupayaan pengurusan kebergantungan yang mudah. Berikut adalah beberapa senario dan perintah lazim ketika menggunakan npm untuk pembangunan harian:

Memulakan Projek Node.js Baharu

Untuk memulakan projek Node.js dalam direktori kosong, gunakan perintah npm init untuk mencipta fail package.json. Fail ini merupakan nadi projek, menyimpan metadata projek, maklumat kebergantungan, serta skrip boleh laksana.

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init akan membimbing anda untuk mengisi nama projek, versi, keterangan, fail utama, dan lain-lain. Anda juga boleh gunakan npm init -y untuk menjana fail package.json dengan nilai lalai secara pantas.

Memasang Kebergantungan Projek

Dalam direktori root projek (iaitu direktori yang mengandungi package.json), anda boleh menggunakan perintah npm install untuk memasang semua kebergantungan yang diperlukan projek anda.

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

Arahan ini akan membaca medan dependencies dan devDependencies dalam package.json, kemudian memuat turun serta memasang modul berkaitan ke dalam direktori node_modules projek.

Menambah Pakej Kebergantungan Baharu

Jika anda ingin menambah pustaka atau rangka kerja baharu ke dalam projek, gunakan perintah npm install <nama-pakej>.

# Pasang kebergantungan runtime, contohnya rangka kerja Express
npm install express

# Pasang kebergantungan pembangunan, contohnya Mocha untuk ujian
npm install mocha --save-dev

Secara lalai, npm install <nama-pakej> akan memasang pakej ke dalam folder node_modules projek dan mengemas kini medan dependencies dalam package.json. Flag --save-dev akan menambah pakej tersebut ke bahagian devDependencies, ini biasanya digunakan untuk alat pembangunan atau ujian.

Mengalih Keluar Pakej Kebergantungan

Jika sesuatu pakej tidak diperlukan lagi dalam projek, anda boleh mengalih keluarnya dengan perintah npm uninstall <nama-pakej>.

npm uninstall express

Pakej akan dipadam daripada folder node_modules dan package.json akan dikemas kini.

Kemas Kini Kebergantungan Projek

Untuk memastikan semua kebergantungan sentiasa menggunakan versi terbaharu (mengikut julat yang ditetapkan dalam package.json), gunakan perintah npm update.

npm update

Arahan ini akan menyemak semua pakej dalam node_modules dan mengemas kini kepada versi terbaru yang sesuai berdasarkan tetapan versi di package.json.

Menggunakan Skrip npm

Medan scripts dalam fail package.json membolehkan anda mentakrif perintah-perintah skrip tersuai. Ianya sangat berguna untuk mengautomasi tugasan berulang seperti menjalankan server pembangunan, melaksanakan ujian, membina projek dan sebagainya.

Sebagai contoh, anda boleh menambah skrip berikut dalam package.json:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

Selepas itu, anda boleh menjalankan skrip tersebut melalui terminal dengan perintah npm run <nama-skrip>:

# Mulakan aplikasi
npm start

# Jalankan ujian
npm test

# Bina projek
npm run build

Perlu diingat, untuk nama skrip tertentu seperti start, test, install, restart, stop, anda boleh abaikan run dan terus menggunakan seperti npm start dan npm test.

Senarai Ringkas Perintah npm Berguna

Selain daripada penggunaan teras di atas, berikut adalah beberapa perintah npm lain yang kerap digunakan:

• Pasang Pakej Secara Global: Untuk pemasangan alat baris perintah yang boleh digunakan di mana-mana dalam sistem.

  npm install -g <nama-pakej>
  # Contoh, pasang npx untuk menjalankan perintah sementara (biasanya datang sekali dengan Node.js)
  npm install -g npx
  # Contoh, pasang alat CLI popular nodemon untuk pembangunan
  npm install -g nodemon

• Jalankan Perintah Sementara (npx): npx disertakan bersama npm versi 5.2 ke atas. Ia digunakan untuk melaksanakan skrip dalam node_modules/.bin atau memuat turun serta menjalankan skrip dari pakej tanpa perlu pemasangan global.

  # Bina aplikasi React baru tanpa perlu memasang create-react-app secara global
  npx create-react-app my-react-app

• Lihat Senarai Pakej Dipasang Secara Global: Senaraikan semua pakej global beserta versinya.

  npm list -g --depth=0

• Bersihkan Cache npm: Kadang kala ralat pemasangan disebabkan isu cache, jadi bersihkan cache boleh membantu.

  npm cache clean --force

• Lihat Maklumat Pakej: Tunjukkan maklumat terperinci tentang sesuatu pakej termasuk versi, kebergantungan, dan repositori.

  npm view <nama-pakej>

• Cari Pakej: Cari pakej dalam repositori npm.

  npm search <kata kunci>

Penyelesaian Masalah

• npm command not found: Pastikan anda telah memasang Node.js menerusi ServBay dan sesi terminal anda boleh mengakses laluan pemasangan Node.js dan npm. Biasanya memulakan semula terminal atau komputer dapat menyelesaikan isu laluan.
• Kegagalan memasang kebergantungan: Periksa sambungan internet anda. Kadang-kadang tetapan proxy syarikat boleh mengganggu pemasangan npm. Anda mungkin perlu mengkonfigurasi proxy untuk npm, atau cuba bersihkan cache npm (npm cache clean --force) sebelum memasang semula.
• Isu keizinan: Pada macOS, pemasangan global (npm install -g) kadang-kadang menyebabkan masalah keizinan. Disarankan menggunakan Node Version Manager (nvm), atau pastikan ServBay telah mengkonfigurasi laluan pemasangan dengan betul. Elakkan gunakan sudo secara langsung untuk pemasangan global kerana ia boleh menyebabkan isu lebih rumit. Node.js yang dipasang melalui ServBay biasanya sudah ditetapkan supaya anda boleh menjalankan arahan npm tanpa isu keizinan dalam direktori pemasangan ServBay.

Rumusan

Dengan ServBay, anda boleh menyiapkan persekitaran pembangunan Node.js yang lengkap secara tempatan dan terus menggunakan alat pengurusan pakej npm yang berkuasa. Menguasai asas penggunaan dan perintah-perintah utama npm akan meningkatkan kecekapan pembangunan anda secara signifikan. Semakin anda menerokai ekosistem Node.js, npm pasti akan menjadi sahabat baik anda dalam pengurusan projek.