Kuidas paigaldada ja kasutada npm-i Ubuntus: Samm-sammult juhend algajatele ja arendajatele

1. Sissejuhatus

Miks kasutada npm-i Ubuntus?

Üks olulisemaid tööriistu nii frontendi kui ka backendi arenduses on npm (Node Package Manager). Npm on laialt kasutusel Node.js paketihaldurina ning võimaldab JavaScripti teeke ja tööriistu lihtsalt paigaldada ja hallata.

Npm-i kasutamine Ubuntu keskkonnas aitab ära kasutada Linuxi sujuvat tööd ja paindlikku paketihaldust, muutes arenduse oluliselt efektiivsemaks. Ubuntu on populaarne distributsioon paljude arendajate seas ning seda kasutatakse laialdaselt nii serverihalduses kui ka lokaalses arenduskeskkonnas.

Eriti Node.js-põhiste raamistikute (nt Vue.js, React, Next.js) puhul on tavapärane kasutada paketihalduseks npm-i. Neid Ubuntu peal üles seades saab võrreldes Windowsi või macOS-iga luua stabiilsema ja vähem probleemse arenduskeskkonna.

Artikli eesmärk

Selles artiklis selgitatakse samm-sammult, kuidas paigaldada npm Ubuntusse ja kasutada selle põhilisi funktsioone. Järgmised sihtrühmad saavad kõige enam kasu:

• Arendajad, kes kasutavad Ubuntu esimest korda
• Need, kes seisavad silmitsi Node.js või npm keskkonna seadistamisega
• Need, kes soovivad õppida npm-i kasutamist süsteemselt

Lisaks tutvustame mitut erinevat installatsiooniviisi, nende eeliseid ja puudusi, samuti tüüpilisi vigu, veaotsingut ja kasulikke käske, et aidata sul Ubuntu peal npm-i edukalt kasutama hakata.

2. Node.js ja npm paigaldamine Ubuntusse

Npm-i kasutamiseks Ubuntus tuleb esmalt paigaldada Node.js, kuna npm tuleb Node.js-iga kaasa. Node.js-i paigaldamisel saab kohe kasutada ka npm-i.

Allpool tutvustame kolme põhilist viisi, kuidas paigaldada Node.js ja npm Ubuntusse. Igal meetodil on omad eelised, seega vali sobiv vastavalt oma vajadustele ja arendamisstiilile.

Meetod 1: Ubuntu ametliku hoidla kasutamine

Sammud

Node.js on olemas Ubuntu vaikimisi hoidlates. See on kõige lihtsam ja sobib hästi algajatele.

sudo apt update
sudo apt install nodejs npm

Pärast paigaldamist kontrolli versioone järgmiste käskudega:

node -v
npm -v

Eelised

• Käsud on lihtsad ja segadusse sattumine on vähetõenäoline
• Pakkumisel on stabiilne versioon, mis tagab töökindluse

Puudused

• Sageli on Node.js/npm versioonid vanemad ja uuemaid funktsioone kasutada ei saa

Meetod 2: NodeSource PPA kasutamine

NodeSource ametliku hoidla kasutamine võimaldab paigaldada uuemaid Node.js-i ja npm-i versioone.

Näide: Node.js 18.x paigaldamine

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

npm paigaldatakse automaatselt koos Node.js-iga.

Eelised

• Võimaldab kasutada stabiilseid, kuid uuemaid versioone
• Paigaldamine on lihtne ja töötab hästi Ubuntu keskkonnas

Puudused

• Nagu teiste PPA-de puhul, võib vaja minna sõltuvuste haldust

Meetod 3: nvm (Node Version Manager) kasutamine

Kui vajad arenduses mitut Node.js versiooni, siis nvm on kõige paindlikum ja mugavam lahendus.

Sammud

Paigalda esmalt nvm:

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

Seejärel lae kest uuesti ja paigalda Node.js nvm-i kaudu:

source ~/.bashrc  # või ~/.zshrc
nvm install 18
nvm use 18

npm paigaldatakse koos Node.js-iga automaatselt.

Eelised

• Võimaldab vabalt vahetada Node.js versioone
• Iga projekti jaoks saab seadistada sobiva versiooni
• Ei mõjuta kogu süsteemi ja on turvaline

Puudused

• Võrreldes teiste meetoditega on seadistamine veidi keerulisem
• Vajab muudatusi terminali konfiguratsioonifailides

Milline meetod valida?

Pikaajalise arenduse puhul soovitatakse enim nvm-i kasutamist Ubuntu peal. Kiire alustamise jaoks on NodeSource PPA hea valik.

3. npm-i põhikasutus

Pärast Node.js ja npm-i paigaldamist Ubuntusse saad alustada npm-i kasutamist pakettide haldamiseks. Npm on võimas tööriist JavaScripti pakkide paigaldamiseks, uuendamiseks ja eemaldamiseks.

Allpool on välja toodud enim kasutatavad npm-i käsud koos selgitustega.

Paketi paigaldamine

Kohalik paigaldus

Paketid, mida kasutatakse ainult kindlas projektis, paigaldatakse kohalikult. Need paigaldatakse node_modules kausta ning kantakse package.json-i.

npm install paketi_nimi

Näide: paigalda axios

npm install axios

Seda paketti saavad kasutada ainult sama projekti skriptid.

Globaalne paigaldus

Kogu süsteemi jaoks mõeldud tööriistad (nt CLI) paigaldatakse globaalselt.

npm install -g paketi_nimi

Näide: http-server globaalselt

sudo npm install -g http-server

Ubuntus võib -g kasutamisel vaja minna sudo-d.

Paketi eemaldamine

Vajadusel saad pakette eemaldada järgmiste käskudega.

Kohaliku paketi eemaldamine

npm uninstall paketi_nimi

Globaalne paketi eemaldamine

sudo npm uninstall -g paketi_nimi

Paketi uuendamine

Paketid saab värskendada järgmiste käskudega.

Üksiku paketi uuendamine

npm update paketi_nimi

Kõikide sõltuvuste korraga uuendamine

npm update

See uuendab paketid vastavalt package.json-is määratud versioonidele.

Arendussõltuvuste paigaldamine (--save-dev)

Ainult arendamisel vajalikke pakette (nt testimis- või ehitustööriistad) paigaldatakse --save-dev valikuga.

npm install --save-dev paketi_nimi

Näide: paigalda jest arendussõltuvusena

npm install --save-dev jest

See lisatakse package.json devDependencies sektsiooni.

Pakettide nimekirja vaatamine

Kohalike pakettide loend

npm list

Globaalsete pakettide loend

npm list -g --depth=0

Valik --depth=0 kuvab ainult tipptaseme paketid, muutes loendi selgemaks.

Projekti sõltuvuste haldamine package.json-ga

Npm-i kasutamisel on oluline package.json fail projekti juurikas. Sinna salvestatakse paketid, versioonid ja skriptid, toimides kogu projekti konfiguratsioonifailina.

Loo package.json järgmise käsuga:

npm init

Kui tahad kiirelt luua vaikimisi väärtustega, kasuta:

npm init -y

4. Levinumad probleemid ja lahendused

Npm-i kasutamisel Ubuntus võib esineda vigu või ootamatut käitumist. Allpool on kirjeldatud tüüpilisi probleeme ning nende lahendusi, millega algajad sageli kokku puutuvad.

Õiguste (permission) vead

Sümptom

EACCES: permission denied

Kui püüad paketti globaalselt paigaldada, võib ilmuda ülaltoodud viga.

Põhjus

See tekib siis, kui kasutajal pole õigusi paigalduskataloogi kirjutamiseks (nt /usr/lib/node_modules). Ubuntu puhul on turvalisuse huvides vaja sudo-d süsteemikataloogide jaoks.

Lahendus

• Käivita käsk sudo-ga:

sudo npm install -g paketi_nimi

• Või muuda globaalsete pakettide paigalduskoht kasutajakausta:

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

Seejärel lisa ~/.bashrc või ~/.profile failile:

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

Muudatus jõustub pärast terminali taaskäivitust või käsuga:

source ~/.bashrc

npm käsk ei tööta, PATH pole määratud

Sümptom

command not found: npm

Kui npm pole leitav, võib põhjus olla allpool.

Põhjus

• node või npm pole õigesti paigaldatud
• PATH keskkonnamuutuja pole õigesti seadistatud

Lahendus

Esmalt kontrolli asukohta:

which npm

Kui midagi ei ilmu, paigalda npm uuesti või kontrolli PATH seadistust. Kui kasutad nvm-i, veendu, et terminali konfiguratsioonifailis (nt .bashrc või .zshrc) oleks nvm-i initsialiseerimise kood:

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

Kindlat paketti ei saa paigaldada, versioonikonfliktid

Sümptom

• Paketi paigaldamisel kuvatakse versioonikonflikti teade
• npm install kuvab palju hoiatusi

Põhjus

Npm annab veateate, kui paketisõltuvused ei klapi või mõni pakett on vananenud.

Lahendus

• Proovi paigaldada uusim versioon:

npm install paketi_nimi@latest

• Vaata sõltuvusi:

npm ls paketi_nimi

• Jõuga paigaldamine (ei soovitata):

npm install --legacy-peer-deps

• Kustuta package-lock.json ja node_modules, siis paigalda uuesti:

rm -rf node_modules package-lock.json
npm install

Muud kasulikud diagnostikakäsud

• npm doctor: Kontrollib süsteemi seadeid

npm doctor

• npm audit: Tuvastab turvaprobleemid ja pakub lahendusi

npm audit
npm audit fix

Ubuntu peal võivad npm-i vead ilmuda ingliskeelsena – loe veateateid tähelepanelikult ja reageeri rahulikult.

5. Korduma kippuvad küsimused (KKK)

Allpool vastatakse lühidalt küsimustele, mida Ubuntu kasutajad npm-i kohta kõige sagedamini esitavad. See aitab vältida tüüpvigu ja luua parema arenduskeskkonna.

K1. Kuidas uuendada npm-i Ubuntu peal uusimale versioonile?

V1.

Uuenda npm järgmise käsuga:

sudo npm install -g npm@latest

Kui kasutad nvm-i, pole sudo-d vaja:

npm install -g npm@latest

Versiooni kontroll:

npm -v

K2. Mis vahe on npm-i globaalsel ja kohaliku paigaldusel?

V2.

• Kohalik paigaldus:
• Halda projektipõhiseid sõltuvusi
• Paigaldatakse node_modules kausta
• Lihtne jagada teiste arendajatega (package.json kaudu)
• Globaalne paigaldus:
• Kasutatakse CLI-tööriistade jaoks kogu süsteemis
• Paigaldatakse tavaliselt /usr/lib/node_modules alla
• Sageli on vaja sudo-d

K3. Mis kasu on nvm-i kasutamisest?

V3.

nvm (Node Version Manager) võimaldab paindlikult vahetada Node.js versioone.

• Võimaldab igas projektis kasutada sobivat Node.js versiooni
• Ei mõjuta kogu süsteemi, turvaline
• npm-i hallatakse automaatselt versiooni kaupa

K4. Mida teha, kui npm-i sõltuvused on katki?

V4.

Eemalda node_modules ja package-lock.json, siis paigalda uuesti:

rm -rf node_modules package-lock.json
npm install

Kui ikka ei aita, proovi npm ci (puhtaks paigaldus, sobib CI/CD jaoks).

K5. Kas npm-i käskude tulemuses kuvatav “WARN” või “audit” on probleem?

V5.

Hoiatused (“WARN”) pole tavaliselt kriitilised, kuid viitavad võimalikele sõltuvusprobleemidele või vananenud funktsioonidele.

Kui ilmub turvahoiatus, kasuta automaatseks paranduseks:

npm audit fix

Muudatuste rakendamisel soovitame kontrollida muudatused üle ja kasutada Git-i versioonihaldust.

K6. Mida saab Ubuntus npm-i abil teha?

V6.

npm on JavaScripti maailma “värav”. Ubuntus saad npm-i abil lihtsalt luua järgmisi asju:

• Frontendi arenduskeskkonnad (React, Vue, Svelte jne)
• Staatiliste saitide generaatorid (Next.js, Nuxt jne)
• Serveripoolne arendus (Express, NestJS jne)
• CLI-tööriistad
• Testimiskeskkonnad (Jest, Mocha jne)

Kasuta Ubuntu peal npm-i, et efektiivselt ja töökindlalt arendada avatud lähtekoodiga lahendusi.

6. Kokkuvõte: Saa npm-i Ubuntus hästi selgeks

Selles artiklis vaatasime, kuidas paigaldada npm Ubuntusse ja kasutada seda tõhusalt. Lõpetuseks peamised punktid:

Artikli peamised punktid

• Mis on npm?: Node.js-i juurde kuuluv paketihaldur, mis suurendab arenduse efektiivsust
• Paigaldusmeetodid Ubuntus: ametlik hoidla, NodeSource, nvm – vali vastavalt vajadusele
• Põhikäsklused: pakettide paigaldus, eemaldamine, uuendamine ja sõltuvuste haldamine
• Vigade lahendamine: nõuanded õiguste, versioonide ja teiste levinud probleemide jaoks
• KKK: vastused tüüpilistele küsimustele arendusprotsessis

Soovitus algajatele

Ubuntu ja npm on suurepärane kombinatsioon kaasaegse veebiarenduse jaoks. Alguses võib tekkida vigu või küsimusi, kuid igat olukorda lahendades saad arendajana kiiresti targemaks.

Kõige olulisem on ise käske proovida. Harju npm-i tööloogikaga ja loe veateateid rahulikult.

See npm-i juhend Ubuntu jaoks on nüüd lõppenud. Loodan, et see aitab sul edukalt arenduskeskkonda üles seada ja oskusi täiendada.

Lisaks jagame jooksvalt rohkem Linuxi ja frontendi arenduse teadmisi – jäta leht järjehoidjatesse ning jaga seda ka sotsiaalmeedias!