Jinsi ya Kutumia npm kwenye Ubuntu: Usakinishaji, Amri za Msingi, na Mwongozo wa Utatuzi wa Tatizo

.## 1. Utangulizi

Kwa Nini Kutumia npm kwenye Ubuntu

Moja ya zana muhimu kwa maendeleo ya mbele na nyuma ni npm (Node Package Manager). npm inatumika sana kama zana ya usimamizi wa vifurushi kwa Node.js, ikiruhusu wasanidiwa kuweka na kusimamia maktaba na zana za JavaScript kwa urahisi.

Kwa kutumia npm kwenye Ubuntu, unaweza kunufaika na utendaji hafifu wa Linux na usimamizi wa vifurushi unaobadilika huku ukiboresha ufanisi wa maendeleo kwa kiasi kikubwa. Ubuntu ni usambazaji unaoungwa mkono na jumuiya kubwa ya wasanidi na hutumika sana kwa kila kitu kutoka kwa shughuli za seva hadi mazingira ya maendeleo ya ndani.

Haswa, unapofanya kazi na mifumo ya Node.js kama Vue.js, React, na Next.js, kusimamia vifurushi kwa npm ndiko njia ya kawaida. Kuweka zana hizi kwenye Ubuntu hukuwezesha kujenga mazingira thabiti ya maendeleo yenye matatizo machache ikilinganishwa na Windows au macOS.

Lengo la Makala Hii

Makala hii inatoa mwongozo wa hatua kwa hatua wa kusakinisha npm kwenye Ubuntu na kumudu matumizi yake ya msingi. Inalenga hasa hadhira zifuatazo:

• Wasanidi ambao ni wapya kwenye Ubuntu
• Wale wanaokumbwa na usanidi wa Node.js au npm
• Yeyote anayetaka kujifunza npm kwa njia iliyopangwa

Njia nyingi za usakinishaji zinaelezewa, pamoja na sifa, faida, na hasara zake. Zaidi ya hayo, mwongozo huu unashughulikia makosa ya kawaida, vidokezo vya utatuzi wa matatizo, na amri muhimu kusaidia wasomaji kutumia npm kwa ufasaha kwenye Ubuntu.

2. Kusakinisha Node.js na npm kwenye Ubuntu

Ili kutumia npm kwenye Ubuntu, lazima kwanza usakinishe Node.js. Kwa kuwa npm imefungwa pamoja na Node.js, usakinishaji wa Node.js unafanya npm ipatikane kiotomatiki.

Hapa kuna njia tatu kuu za kusakinisha Node.js na npm kwenye Ubuntu. Kila njia ina sifa zake, hivyo ni muhimu kuchagua ile inayofaa zaidi kwa mtindo wako wa maendeleo na lengo lako.

Njia ya 1: Kutumia Hifadhi Rasmi ya Ubuntu

Hatua

Node.js inapatikana katika hifadhidata za kawaida za Ubuntu. Hii ndiyo njia rahisi na rafiki kwa wanaoanza.

sudo apt update
sudo apt install nodejs npm

Baada ya usakinishaji, unaweza kuangalia matoleo kwa kutumia amri zifuatazo:

node -v
npm -v

Faida

• Amri rahisi ambazo ni za kueleweka
• Matoleo thabiti yanayotolewa na Ubuntu

Hasara

• Matoleo ya Node.js na npm mara nyingi huwa ya zamani, hivyo sifa mpya huenda zisipatikane

Njia ya 2: Kutumia NodeSource PPA

Kwa kutumia hifadhi ya NodeSource, ambayo inafuata kwa karibu usaidizi rasmi wa Node.js, unaweza kusakinisha matoleo mapya ya Node.js na npm.

Hatua (Mfano: Kusakinisha Node.js 18.x)

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

npm husika husakinishwa kiotomatiki pamoja na Node.js.

Faida

• Upatikanaji wa matoleo mapya na thabiti
• Usakinishaji rahisi na ulinganifu mzuri na Ubuntu

Hasara

• Kama ilivyo kwa PPA nyingine, usimamizi wa utegemezi unaweza kuhitaji kufanywa

Njia ya 3: Kutumia nvm (Node Version Manager)

Kama unataka kubadilisha kati ya matoleo mengi ya Node.js, kutumia nvm ndiko chaguo lenye ubunifu na nguvu zaidi.

Hatua

Kwanza, sakinisha nvm:

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

Kisha pakia upya shell yako na usakinishe Node.js kwa kutumia nvm:

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

npm husika husakinishwa kiotomatiki pamoja na Node.js.

Faida

• Badilisha matoleo ya Node.js kwa uhuru
• Weka matoleo sahihi kwa kila mradi
• Salama, kwani haiguati mfumo kwa ujumla

Hasara

• Usanidi kidogo mgumu ikilinganishwa na njia nyingine
• Inahitaji kuhariri faili za usanidi wa shell

Ni Njia Ipi Unapaswa Kuchagua?

Kwa ujumla, nvm ndiyo chaguo linalopendekezwa zaidi kwa maendeleo ya npm ya muda mrefu kwenye Ubuntu. Hata hivyo, ikiwa unataka usanidi wa haraka na rahisi, kutumia NodeSource PPA pia ni chaguo thabiti.

3. Matumizi ya Msingi ya npm

Mara Node.js na npm zimesakinishwa kwenye Ubuntu, unaweza kuanza kusimamia vifurushi kwa kutumia npm. npm ni chombo chenye nguvu kwa usakinishaji, usasishaji, na kuondoa vifurushi vya JavaScript.

Sehemu hii inatoa maelezo ya amri za npm zinazotumika mara kwa mara na shughuli za msingi.

Kusakinisha Vifurushi

Usakinishaji wa Kitaalamu

Vifurushi vinavyotumika tu ndani ya mradi maalum vinapaswa kusakinishwa kwa kitaalamu. Hii ndiyo njia ya kawaida. Vifurushi husakinishwa katika saraka ya node_modules na kuandikwa katika package.json.

npm install package-name

Mfano: Kusakinisha axios

npm install axios

Mabango tu ndani ya mradi huo huo yanaweza kutumia vifurushi vilivyosakinishwa kwa kitaalamu.

Usakinishaji wa Kimataifa

Zana zinazotumika katika mfumo mzima, kama vile vifaa vya CLI, zinapaswa kusakinishwa kwa kimataifa.

npm install -g package-name

Mfano: Kusakinisha http-server kwa kimataifa

sudo npm install -g http-server

Kwenye Ubuntu, kutumia -g kunaweza kuhitaji sudo.

Kuondoa Vifurushi

Kuondoa Vifurushi vya Kitaalamu

npm uninstall package-name

Kuondoa Vifurushi vya Kimataifa

sudo npm uninstall -g package-name

Kusasisha Vifurushi

Kusasisha Kifurushi Maalum

npm update package-name

Kusasisha Mategemeo Yote

npm update

Usasishaji hutumika ndani ya safu za toleo zilizobainishwa katika package.json, hivyo zingatia vikwazo vya toleo.

Kusakinisha Mategemeo ya Maendeleo (–save-dev)

Vifurushi vinavyotumika tu kwa maendeleo kama vile zana za upimaji au ujenzi vinapaswa kusakinishwa kwa kutumia chaguo la --save-dev.

npm install --save-dev package-name

Mfano: Kusakinisha jest kama tegemeo la maendeleo

npm install --save-dev jest

Hii inaandika kifurushi chini ya devDependencies katika package.json.

Orodha ya Vifurushi Vilivyosasakinishwa

Orodha ya Vifurushi vya Kitaalamu

npm list

Orodha ya Vifurushi vya Kimataifa

npm list -g --depth=0

Kutumia --depth=0 inaonyesha vifurushi vya ngazi ya juu pekee, na kufanya matokeo yasomeke kwa urahisi.

Kusimamia Mategemeo kwa package.json

Faili la package.json ni sehemu ya msingi ya miradi inayotegemea npm. Inarekodi majina ya vifurushi, matoleo, mabango, na usanidi wa jumla wa mradi.

Unaweza kuunda kwa kutumia:

npm init

Kwa usanidi rahisi na thamani chaguomsingi:

npm init -y

4. Matatizo ya Kawaida na Suluhisho

Unapotumia npm kwenye Ubuntu, unaweza kukutana na makosa au tabia zisizotarajiwa. Sehemu hii inatoa maelezo ya matatizo ya kawaida na jinsi ya kuyatatua.

Makosa ya Ruhusa

Dalili

EACCES: permission denied

Sababu

Hii hutokea wakati mtumiaji wa sasa hana ruhusa ya kuandika kwenye saraka ambako npm inajaribu kusakinisha vifurushi. Kwenye Ubuntu, kuandika kwenye saraka za mfumo kama /usr/lib/node_modules kunahitaji sudo.

Suluhisho

• Endesha kwa sudo :

  sudo npm install -g package-name
  

• Au badilisha saraka ya usakinishaji wa kimataifa kuwa njia inayomilikiwa na mtumiaji:

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

Ongeza yafuatayo kwenye ~/.bashrc au ~/.profile:

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

Tumia mabadiliko:

source ~/.bashrc

Amri ya npm Haijapatikana

Dalili

command not found: npm

Sababu

• Usakinishaji wa Node.js au npm umeshindwa
• Kigezo cha mazingira cha PATH hakijapakuliwa

Suluhisho

Angalia njia:

which npm

Kama hakuna matokeo, reinstall au thibitisha mipangilio ya PATH. Ikiwa unatumia nvm, hakikisha msimbo wa uanzishaji upo katika faili yako ya usanidi wa shell:

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

Kushindwa kwa Usakinishaji wa Kifurushi au Migogoro ya Matoleo

Dalili

• Migogoro ya toleo wakati wa kusanikisha kifurushi
• Maonyo mengi wakati wa npm install

Suluhisho

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Amri Muhimu za Uchunguzi

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Masuala Yanayoulizwa Mara Kwa Mara (FAQ)

Swali la 1. Ninawezaje kusasisha npm hadi toleo la hivi karibuni kwenye Ubuntu?

Jibu la 1.

sudo npm install -g npm@latest

Ikiwa unatumia nvm, sudo haihitajiki.

Swali la 2. Ni tofauti gani kati ya usanikishaji wa kimataifa na wa ndani?

Jibu la 2.

• Usanikishaji wa Ndani : Utegemezi maalum wa mradi uliohifadhiwa katika node_modules
• Usanikishaji wa Kimataifa : Zana za CLI za mfumo mzima, mara nyingi zinahitaji sudo

Swali la 3. Ni faida gani za kutumia nvm?

Jibu la 3.

nvm inakuruhusu kubadili kati ya matoleo mengi ya Node.js kwa usalama na ufanisi, na hivyo kuifanya iwe bora kwa maendeleo ya miradi mingi.

Swali la 4. Nifanye nini ikiwa utegemezi wa npm umeharibika?

Jibu la 4.

rm -rf node_modules package-lock.json
npm install

Swali la 5. Je, ujumbe wa npm WARN na ukaguzi ni tatizo?

Jibu la 5.

Maonyo si mautamu lakini yanaonyesha masuala yanayowezekana. Kwa maonyo yanayohusiana na usalama, unaweza kujaribu:

npm audit fix

Swali la 6. Ninaweza kujenga nini kwa kutumia npm kwenye Ubuntu?

Jibu la 6.

• Mitandao ya mbele (React, Vue, Svelte)
• Jenereta za tovuti tuli (Next.js, Nuxt)
• Programu za nyuma (Express, NestJS)
• Zana za CLI
• Mazingira ya majaribio

6. Hitimisho: Jifunze npm kwenye Ubuntu

Nakala hii imeshughulikia mambo ya msingi ya kusanikisha na kutumia npm kwenye Ubuntu, kutoka kwa usanidi hadi kurekebisha matatizo.

Hatua muhimu zaidi ni kufanya majaribio kwa mikono. Kwa kuendesha amri na kuelewa ujumbe wa makosa, utaimarisha ustadi wako kama mwanabunifu hatua kwa hatua.

Hii inahitimisha mwongozo kamili wa kutumia npm kwenye Ubuntu. Tunatumai inakusaidia kujenga mazingira bora na yenye nguvu ya maendeleo.