Gawing Mahusay ang npm sa Ubuntu! Gabay sa Pag-iinstall, Basic na Operasyon, at Paglutas sa Error

目次

1. Panimula

Mga Dahilan para Gumamit ng npm sa Ubuntu

Isa sa mga hindi mawawala na tool sa frontend at backend development ay ang “npm (Node Package Manager)”. Ang npm ay malawak na ginagamit bilang package management tool ng Node.js, at madaling i-install at i-manage ang mga library at tool ng JavaScript.

Sa pamamagitan ng paggamit ng npm sa Ubuntu environment, maaari nating mapakinabangan ang kakaibang mabilis at magaan na operasyon ng Linux pati na ang flexibility ng package management, na lubos na mapapataas ang kahusayan ng development. Ang Ubuntu ay isang distribution na sinusuportahan ng maraming developer, at malawak na ginagamit mula sa server operations hanggang sa local development environment.

Lalo na kapag hawak ang mga Node.js-based framework (Vue.js, React, Next.js atbp.), karaniwang ginagamit ang npm para i-manage ang mga package. Sa pamamagitan ng pag-setup nito sa Ubuntu, mas kaunti ang mga problema kumpara sa Windows o macOS, at maaaring bumuo ng stable na development environment.

Layunin ng Artikul na Ito

Sa artikulong ito, ipapaliwanag nang mabuti ang mga hakbang para i-introduce ang npm sa Ubuntu at master ang basic na paggamit hanggang sa huli. Lalo na para sa mga sumusunod na uri ng tao.

  • Mga developer na baguhan sa Ubuntu
  • Mga taong nagkakaroon ng problema sa environment setup ng Node.js o npm
  • Mga gustong matutunan nang sistematiko ang paggamit ng npm

Bukod dito, ipapakita ang maraming approach sa installation method, kasama ang mga tampok, benepisyo at demerits ng bawat isa. Dagdag pa, mga karaniwang error at paraan ng pagtama ng problema, pati na ang koleksyon ng magagamit na command, upang ang mga mambabasa ay makapag-gamit ng npm sa Ubuntu nang maayos at walang abala.

2. Paraan ng Pag-install ng Node.js at npm sa Ubuntu

Sa Ubuntu, upang magamit ang npm, kailangan muna i-install ang Node.js. Ito ay dahil ang npm ay ibinibigay kasama ang Node.js, kaya kapag na-install ang Node.js, magagamit din ang npm nang sabay-sabay.

Sa bahaging ito, ipapakita namin ang tatlong pangunahing paraan ng pag-install ng Node.js at npm sa Ubuntu. May kanya-kanyang katangian ang bawat paraan, kaya mahalagang pumili ng pinakamainam batay sa layunin o estilo ng pag-develop.

Paraan 1: Gumamit ng Opisyal na Repository ng Ubuntu

Mga Hakbang

May Node.js sa standard repository ng Ubuntu. Ito ang pinakamadali at angkop para sa mga baguhan.

sudo apt update
sudo apt install nodejs npm

Pagkatapos ng pag-install, maaari mong suriin ang bersyon gamit ang mga sumusunod na command:

node -v
npm -v

Mga Kalamangan

  • Simple ang mga command at hindi madaling malito
  • May stable na bersyon na ibinibigay kaya ligtas

Mga Kahinaan

  • Madalas na luma ang bersyon ng Node.js/npm na ibinibigay, kaya hindi magagamit ang pinakabagong tampok sa ilang pagkakataon

Paraan 2: Gumamit ng PPA ng NodeSource

Gamit ang repository na “NodeSource” na malapit sa opisyal na suporta ng Node.js, maaari kang mag-install ng mas bagong bersyon ng Node.js at npm.

Mga Hakbang (Halimbawa: Pag-install ng Node.js 18.x)

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

Ang npm ay awtomatikong maii-install kasama ang Node.js.

Mga Kalamangan

  • Maaaring gumamit ng stable ngunit mas bagong bersyon
  • Madali ang pag-install, at maganda ang compatibility sa Ubuntu

Mga Kahinaan

  • Tulad ng iba pang PPA, maaaring kailangang pamahalaan ang mga dependency ng system

Paraan 3: Gumamit ng nvm (Node Version Manager)

Kung nais mong magpalit-palit ng maraming bersyon ng Node.js habang nagde-develop, ang paggamit ng nvm ang pinaka-flexible at convenient.

Mga Hakbang

Muna, i-install ang nvm:

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

Pagkatapos, i-reload ang shell at i-install ang Node.js gamit ang nvm:

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

Ang npm ay awtomatikong maii-install kasama ang Node.js.

Mga Kalamangan

  • Maaaring palitan nang libre ang bersyon ng Node.js
  • Maaaring i-set ang angkop na bersyon bawat proyekto
  • Hindi naaapektuhan ang buong system, kaya ligtas

Mga Kahinaan

  • Mas komplikado ang mga hakbang kumpara sa iba pang paraan
  • Kailangang baguhin ang config file ng terminal

Aling Paraan ang Dapat Piliin?

ParaanKahirapanKabaguhan ng BersyonKa-flexibilidadInirerekomendang Target
Opisyal na Repository★☆☆△ (Luma)×Mga Baguhan, Mga Nais Subukan
NodeSource★★☆○ (Kung Ikumpara, Bago)Mga Karaniwang Developer
nvm★★★◎ (Malayang Mapipili)Mga Nagha-handle ng Maraming Proyekto, Mga Advanced

Sa pangunahing, kung nais mong mag-develop gamit ang npm sa Ubuntu nang matagal, ang nvm ang pinaka-inirerekomenda. Gayunpaman, kung nais mong madaling simulan, mabuti ring pagpili ang paggamit ng PPA ng NodeSource.

3. Basicong Paggamit ng npm

Kung ang kapaligiran ng Node.js at npm ay handa na sa Ubuntu, susunod na ay subukan nating pamahalaan ang mga package gamit ang npm nang aktwal. Ang npm ay isang makapangyarihang tool para sa pag-install, pag-update, at pag-delete ng mga package ng JavaScript.

Dito, tatalakayin natin ang basicong paggamit ng npm, na nakatuon sa mga karaniwang ginagamit na command.

Ang Pag-install ng Package

Local na Pag-install

Ang mga package na gagamitin lamang sa loob ng isang partikular na proyekto ay local na i-iinstall. Ito ang karaniwang paraan, at i-iinstall ito sa node_modules directory, at ire-record sa package.json.

npm install pangalan_ng_package

Halimbawa: Kung i-iinstall ang axios

npm install axios

Sa pamamaraang ito, ang package ay magagamit lamang sa mga script sa loob ng parehong proyekto.

Global na Pag-install

Ang mga tool na gagamitin sa buong sistema (tulad ng CLI) ay global na i-iinstall.

npm install -g pangalan_ng_package

Halimbawa: Global na pag-install ng http-server

sudo npm install -g http-server

Sa Ubuntu, maaaring kailanganin ang sudo kapag gumagamit ng -g option.

Ang Pag-uninstall ng Package

Ang mga hindi na kailangang package ay maaaring tanggalin gamit ang sumusunod na command.

Ang Pag-delete ng Local na Package

npm uninstall pangalan_ng_package

Ang Pag-delete ng Global na Package

sudo npm uninstall -g pangalan_ng_package

Ang Pag-update ng Package

Kung nais mong i-update ang package sa pinakabagong bersyon, gawin ito nang ganito.

Ang Pag-update ng Indibidwal na Package

npm update pangalan_ng_package

Ang Pag-update ng Lahat ng Mga Dependent Package nang Isa-isa

npm update

Gayunpaman, ang pag-update ay limitado sa saklaw ng bersyon na tinukoy sa package.json, kaya mag-ingat sa mga numero ng bersyon.

Ang Pag-install ng Development Package (–save-dev)

Ang mga tool para sa testing o building na hindi gagamitin sa production environment ay i-iinstall gamit ang --save-dev option.

npm install --save-dev pangalan_ng_package

Halimbawa: Pag-install ng jest bilang development dependency

npm install --save-dev jest

Dahil dito, ire-record ito sa devDependencies section ng package.json.

Ang Pagsusuri ng Listahan ng Package

Ang Pagsusuri ng Listahan ng Local na Package

npm list

Ang Pagsusuri ng Listahan ng Global na Package

npm list -g --depth=0

Gamit ang --depth=0, ipapakita lamang ang top-level packages, na mas madaling tingnan.

Ang Pamamahala ng Dependencies ng Proyekto gamit ang package.json

Ang mahalaga sa paggamit ng npm ay ang package.json file na nilikha sa root ng proyekto. Ang file na ito ay naglalaman ng mga pangalan ng package, impormasyon sa bersyon, definisyon ng script, at iba pa, na gumagana bilang config file ng buong proyekto.

Maaaring likhain ang package.json gamit ang sumusunod na command,

npm init

Maaari ring mag-input sa interactive mode, o kung nais mong gawing simple,

npm init -y

at awtomatikong mabubuo ito gamit ang default values.

4. Mga Karaniwang Problema at ang mga Solusyon Nito

Kapag gumagamit ng npm sa Ubuntu, maaaring makaharap ang mga error o hindi inaasahang pag-uugali. Sa bahaging ito, ipapakita ang mga kinatawan na problema na madaling mahadlangan ng mga baguhan at ang mga paraan ng paghawak dito.

Nangyayari ang Error sa Pahintulot (Permission)

Sintomas

EACCES: permission denied

Kapag sinubukan ang global na pag-install sa npm, maaaring lumabas ang ganoong error.

Dahilan

Nangyayari ito kapag walang karapatang magsulat ang kasalukuyang user sa direktoryong sinusubukang i-install ng npm ang package. Sa Ubuntu, dahil sa mga dahilan ng seguridad, kailangan ng sudo para sa pagsusulat sa mga system directory tulad ng /usr/lib/node_modules.

Paraan ng Pag-ayos

  • I-execute na may sudo:
sudo npm install -g package_name
  • O kaya, baguhin ang lokasyon ng global na pag-install sa user directory para magagamit nang walang sudo:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

Pagkatapos, idagdag ang sumusunod sa ~/.bashrc o ~/.profile para i-set ang PATH:

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

Para maipaliwanag ang mga setting, i-restart ang terminal o i-execute ang sumusunod:

source ~/.bashrc

Hindi Magagamit ang npm Command, Walang PATH

Sintomas

command not found: npm

Bagamat na-install na ang npm, maaaring hindi pa rin makilala ang command.

Dahilan

  • Hindi natapos nang tama ang pag-install ng node o npm
  • Walang PATH (hindi naka-set ang environment variable)

Paraan ng Pag-ayos

Una, suriin ang PATH:

which npm

Kung walang lalabas, kailangan ng re-install o pag-check ng PATH setting. Kung gumagamit ng nvm, suriin ang mga config file ng terminal (hal.: .bashrc, .zshrc) kung may nvm initialization code ba.

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

Hindi Ma-install ang Tiyak na Package, Konplikto ng Bersyon

Sintomas

  • Kapag ni-install ang Package A, ipapakita na hindi tugma ang bersyon ng dependent package
  • Maraming babala ang lumalabas sa npm install

Dahilan

Sa npm, kung may salungatan sa mga dependency ng mga package, lalabas ang error o babala. Bukod dito, maaaring deprecated na ang mga package na ginamit sa lumang proyekto.

Paraan ng Pag-ayos

  • Subukan ang pag-install ng pinakabagong bersyon:
npm install package_name@latest
  • Suriin ang dependency ng package:
npm ls package_name
  • Pipiliting i-install (※ hindi inirerekomenda)
npm install --legacy-peer-deps
  • I-delete muna ang package-lock.json o node_modules at ulitin nang malinis:
rm -rf node_modules package-lock.json
npm install

Iba Pang Kapaki-pakinabang na Teknikal sa Debugging

  • npm doctor: Suriin ang system environment
npm doctor
  • npm audit: Tukuyin ang mga isyu sa seguridad at magmungkahi ng mga paraan ng pag-ayos
npm audit
npm audit fix

Ang mga error ng npm sa Ubuntu ay madalas na may mensahe sa English, kaya maraming nababagabag, ngunit ang mabuting pagbasa ng laman ng error message at kalmadong pagtugon ang pinakamadaliang daan patungo sa solusyon.

5. Mga Madalas na Tanong (FAQ)

Dito, sasagutin natin nang maikli ang mga karaniwang tanong o madalas na hinahanap na tanong ng mga baguhan sa paggamit ng npm sa Ubuntu. Gamitin ito upang maiwasan ang mga problema nang maaga at bumuo ng mas komportableng kapaligiran sa pag-unlad.

Q1. Paano i-update ang npm sa pinakabagong bersyon sa Ubuntu?

A1.

Sa pamamagitan ng pag-execute ng sumusunod na command, maaari mong i-update ang npm sa pinakabagong bersyon.

sudo npm install -g npm@latest

Kung gumagamit ka ng nvm, hindi kailangan ang sudo:

npm install -g npm@latest

Pag-verify ng bersyon:

npm -v

Q2. Ano ang pagkakaiba ng “global installation” at “local installation” ng npm?

A2.

  • Local installation:
  • Pamamanage ng mga dependency bawat proyekto
  • Nakaimbak sa node_modules directory
  • Madaling i-share sa mga developer (nire-record sa package.json)
  • Global installation:
  • Gamitin para sa CLI tools at iba pa na kailangan sa buong system
  • Sa Ubuntu, madalas na nainstall sa /usr/lib/node_modules
  • Minsan kailangan ng sudo

Q3. Ano ang mga benepisyo ng paggamit ng nvm?

A3.

Sa pamamagitan ng nvm (Node Version Manager), maaari kang mag-switch ng maraming bersyon ng Node.js nang libre.

  • Perpekto para sa mga proyekto na gumagamit ng iba’t ibang bersyon ng Node.js
  • Hindi nakakaapekto sa buong system kaya ligtas
  • Ang npm ay awtomatikong namamahala bawat bersyon, kaya napakabilis ng pagbuo ng kapaligiran

Q4. Ano ang gagawin kung sira ang dependency ng npm?

A4.

Unahin, tanggalin ang node_modules at package-lock.json tapos i-reinstall.

rm -rf node_modules package-lock.json
npm install

Kung hindi pa rin ayusin, subukan ang npm ci command (para sa clean install sa CI/CD environment).

Q5. Lumalabas na “WARN” o “audit” sa resulta ng npm command, okay lang ba?

A5.

Ang babala (WARN) ay hindi malubhang error, pero senyales ito ng problema sa dependency o paggamit ng hindi inirerekomendang feature.

Kung may babala sa security, maaari mong subukan ang awtomatikong pagkukumpuni sa sumusunod na command:

npm audit fix

Gayunpaman, upang maging maingat, suriin muna ang mga pagbabago, i-version control gamit ang Git bago i-apply.

Q6. Ano ang maaaring gawin gamit ang npm sa Ubuntu?

A6.

Ang npm ay ang “pinto” sa mundo ng JavaScript. Maaari kang bumuo ng mga sumusunod nang madali sa Ubuntu:

  • Frontend development environment (React, Vue, Svelte at iba pa)
  • Static site generator (Next.js, Nuxt at iba pa)
  • Server-side development (Express, NestJS at iba pa)
  • Development ng CLI tools
  • Test environment (Jest, Mocha at iba pa)

Sa paggamit ng npm sa Ubuntu, maaari kang mag-leverage ng open source nang mahusay at matibay na pag-unlad.

6. Buod: Gamitin nang Mahusay ang npm sa Ubuntu

Sa artikulong ito, ipinaliwanag ang mga batayang kaalaman at praktikal na mga command para sa pagpapakilala ng npm sa Ubuntu at ang aktwal na paggamit nito. Sa huli, balik-aralin natin ang mga punto.

Mga Mahahalagang Punto ng Artikul na Ito

  • Ano ang npm: Isang tool sa pamamahala ng package na kasama sa Node.js na nagpapahusay nang malaki sa kahusayan ng pag-unlad
  • Paraan ng Pag-install sa Ubuntu: May tatlong paraan: opisyal na repository, NodeSource, nvm, at maaaring piliin ayon sa layunin
  • Mga Batayang Operasyon: Madaling gawin ang pag-install, pagbura, pag-update ng mga package, pamamahala ng dependencies, at iba pa
  • Pagresolba ng Problema: Ipinakilala ang mga kaalamang makakatulong sa paghawak ng mga problema sa pahintulot at bersyon
  • FAQ: Maingat na sinagot ang mga karaniwang tanong at alalahanin sa aktwal na mga site ng pag-unlad

Isang Salita para sa Mga Baguhan

Ang Ubuntu at npm ay may napakagandang pagkakasundo, isang makapangyarihang kombinasyon para sa komportableng modernong web development. Sa simula, maaaring magkaroon ng mga error o hindi malinaw na punto, ngunit habang hinahawakan mo sila isa-isa, lalalim ang iyong pag-unawa bilang developer.

Ang pinakamahalaga ay ‘subukan ito sa pamamagitan ng paggalaw ng mga kamay’. Habang nag-e-execute ng bawat command, sanayin natin ang sarili sa pag-uugali ng npm at mga error message.

Sa ganito, natapos na ang gabay sa paggamit ng npm sa kapaligiran ng Ubuntu. Sana makatulong ang artikulong ito sa pagbuo ng iyong development environment at pagpapahusay ng skills.

Ipo-publish din namin ang iba pang mga kaalamang tungkol sa Linux at impormasyon tungkol sa frontend development nang paisa-isa, kaya mangyaring i-bookmark at i-share sa SNS!