Ubuntu හි npm භාවිතා කරන ආකාරය: ස්ථාපනය, මූලික විධාන, සහ ගැටළු විසඳුම් මාර්ගෝපදේශය

.## 1. හැඳින්වීම

目次

Ubuntu හි npm භාවිතා කිරීමේ හේතුව

ඉදිරිපස සහ පසුපස සංවර්ධනය සඳහා අවශ්‍යම මෙවලම්之一 වන npm (Node Package Manager) වේ. npm යනු Node.js සඳහා පැකේජ් කළමනාකරණ මෙවලමක් වන අතර, සංවර්ධකයින්ට JavaScript පුස්තකාල සහ මෙවලම් පහසුවෙන් ස්ථාපනය කර කළමනාකරණය කිරීමට ඉඩ සලසයි.

Ubuntu හි npm භාවිතා කිරීමෙන්, Linux හි ලාංඡාමය කාර්ය සාධනය සහ ලවච්චි පැකේජ් කළමනාකරණය ප්‍රයෝජනයට ගෙන, සංවර්ධන කාර්යක්ෂමතාවය ගණනාවක් වැඩි කරගත හැකිය. Ubuntu යනු විශාල සංවර්ධක ප්‍රජාවක් සහය දක්වන බෙදාහැරීමක් වන අතර, සේවාදායක මෙහෙයුම් වලින් සිට දේශීය සංවර්ධන පරිසරයන් දක්වා විවිධ අවශ්‍යතා සඳහා පුළුල් ලෙස භාවිතා වේ.

විශේෂයෙන් Vue.js, React, Next.js වැනි Node.js-අධාරිත රාමුවල සමඟ වැඩ කරන විට, npm මඟින් පැකේජ් කළමනාකරණය කිරීම සාමාන්‍ය ක්‍රමවේදයකි. Ubuntu හි මෙම මෙවලම් සකස් කිරීමෙන්, Windows හෝ macOS සමඟ සැසඳුනේ වඩා අඩු ගැටළු සමඟ ස්ථායි සංවර්ධන පරිසරයක් ගොඩනැගිය හැකිය.

මෙම ලිපියේ අරමුණ

මෙම ලිපිය Ubuntu හි npm ස්ථාපනය කිරීමේ පියවර-පියවර මාර්ගෝපදේශයක් සහ එහි මූලික භාවිතය පිළිබඳ පූර්ණ මාර්ගෝපදේශයක් ලබා දේ. එය විශේෂයෙන් පහත පිරිස සඳහා නිර්දේශිත වේ:

  • Ubuntu නවකයන්
  • Node.js හෝ npm සැකසීමේදී ගැටළු අත්විඳින අය
  • සංවිධානයකින් npm ඉගෙන ගැනීමට කැමති ඕනෑම කෙනෙකු

විවිධ ස්ථාපන ක්‍රම කිහිපයක්, ඒවායේ විශේෂාංග, වාසි, හා අවාසි ඉදිරිපත් කර ඇත. එමෙන්ම, පොදු දෝෂ, ගැටළු විසඳුම් උපදෙස්, සහ Ubuntu හි npm සාර්ථකව භාවිතා කිරීමට ප්‍රයෝජනවත් විධානද මෙහි අඩංගු වේ.

2. Ubuntu හි Node.js සහ npm ස්ථාපනය කිරීම

Ubuntu හි npm භාවිතා කිරීමට, පළමුව Node.js ස්ථාපනය කළ යුතුය. npm යනු Node.js සමඟ එකට පැකේජ් කර ඇති බැවින්, Node.js ස්ථාපනය කිරීමෙන් npm ස්වයංක්‍රීයව ලබා ගත හැකිය.

Node.js සහ npm Ubuntu හි ස්ථාපනය කිරීම සඳහා ප්‍රධාන වශයෙන් තේරීම් තුනක් ඇත. එක් එක් ක්‍රමයම තමන්ගේම ලක්ෂණ ඇති බැවින්, ඔබේ සංවර්ධන රටාව සහ අරමුණට සුදුසු ක්‍රමය තෝරා ගැනීම වැදගත් වේ.

ක්‍රමය 1: නිල Ubuntu රෙපොසිටරිය භාවිතා කිරීම

පියවරයන්

Node.js Ubuntu හි සාමාන්‍ය රෙපොසිටරීන් තුළ ලබා ගත හැකිය. මෙය සරලම සහ නවකයන්ට සුදුසුම ක්‍රමය වේ.

sudo apt update
sudo apt install nodejs npm

ස්ථාපනයෙන් පසු, පහත විධාන භාවිතා කර අනුවාද පරීක්ෂා කළ හැකිය:

node -v
npm -v

වාසි

  • අවබෝධයට පහසු සරල විධාන
  • Ubuntu විසින් ලබා දෙන ස්ථායි අනුවාද

අවාසි

  • Node.js සහ npm අනුවාද බොහෝ විට පරණවීම නිසා නවතම විශේෂාංග ලබා ගැනීමට නොහැකිය

ක්‍රමය 2: NodeSource PPA භාවිතා කිරීම

NodeSource රෙපොසිටරිය, නිල Node.js සහය සමඟ සමීපව අනුගත වන බැවින්, නවතම Node.js සහ npm අනුවාද ස්ථාපනය කළ හැකිය.

පියවරයන් (උදාහරණය: Node.js 18.x ස්ථාපනය)

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

npm ස්වයංක්‍රීයව Node.js සමඟ ස්ථාපනය වේ.

වාසි

  • සාපේක්ෂව නවතම හා ස්ථායි අනුවාද ලබා ගැනීම
  • Ubuntu සමඟ අනුකූලව පහසු ස්ථාපනය

අවාසි

  • අනෙකුත් PPA වැනි, පරාමිතීන් කළමනාකරණය අවශ්‍ය විය හැකිය

ක්‍රමය 3: nvm (Node Version Manager) භාවිතා කිරීම

බහු Node.js අනුවාද අතර මාරු කිරීමට අවශ්‍ය නම්, nvm භාවිතා කිරීම අතිශය ලවච්චි සහ ශක්තිමත් විකල්පයකි.

පියවරයන්

පළමුව nvm ස්ථාපනය කරන්න:

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

ඊළඟට ඔබේ shell නැවත පූරණය කර, nvm මඟින් Node.js ස්ථාපනය කරන්න:

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

npm ස්වයංක්‍රීයව Node.js සමඟ ස්ථාපනය වේ.

වාසි

  • Node.js අනුවාද අතර නිදහස් මාරු කිරීම
  • ව්‍යාපෘතිය අනුව සුදුසු අනුවාද සකස් කිරීම
  • පද්ධතියේ ගෝලීය ස්ථාපනයට බලපාන්නේ නැති නිසා ආරක්ෂිතයි

අවාසි

  • අනෙකුත් ක්‍රමවලට වඩා සංකීර්ණ සැකසීම
  • Shell වින්‍යාස ගොනු (configuration files) සංස්කරණය කිරීම අවශ්‍ය වේ

ඔබට කුමන ක්‍රමය තෝරා ගත යුතුද?

MethodDifficultyVersion FreshnessFlexibilityRecommended For
Official Repository★☆☆△ (Older)×Beginners, first-time users
NodeSource★★☆○ (Relatively new)General developers
nvm★★★◎ (Freely selectable)Advanced users, multi-project workflows

සාමාන්‍යයෙන්, Ubuntu හි දිගුකාලීන npm සංවර්ධනය සඳහා nvm යනු වඩාත්ම නිර්දේශිත විකල්පයයි. කෙසේ වෙතත්, ඉක්මන් සහ සරල සැකසුමක් අවශ්‍ය නම්, NodeSource PPA භාවිතා කිරීම ද තවත් ශක්තිමත් තේරීමකි.

3. npm හි මූලික භාවිතය

Ubuntu හි Node.js සහ npm ස්ථාපනය කරන විට, npm භාවිතයෙන් පැකේජ් කළමනාකරණය ආරම්භ කළ හැකිය. npm යනු JavaScript පැකේජ් ස්ථාපනය, යාවත්කාලීන කිරීම සහ ඉවත් කිරීම සඳහා ශක්තිමත් මෙවලමකි.

මෙම කොටසෙහි npm හි සාමාන්‍යයෙන් භාවිතා වන ප්‍රකාශන සහ මූලික මෙහෙයුම් හඳුන්වා දෙයි.

පැකේජ් ස්ථාපනය

දේශීය ස්ථාපනය

විශේෂිත ව්‍යාපෘතිය තුළ පමණක් භාවිතා වන පැකේජ් දේශීයව ස්ථාපනය කළ යුතුය. මෙය සම්මත ප්‍රවේශයකි. පැකේජ් node_modules නාමාවලිය තුළ ස්ථාපනය වන අතර package.json හි ලියාපදිංචි වේ.

npm install package-name

උදාහරණය: axios ස්ථාපනය

npm install axios

එම ව්‍යාපෘතිය තුළ පමණක් ස්ක්‍රිප්ට් දේශීයව ස්ථාපිත පැකේජ් භාවිතා කළ හැකිය.

ගෝලීය ස්ථාපනය

පද්ධති ව්‍යාප්තියෙන් භාවිතා වන මෙවලම්, උදාහරණයක් ලෙස CLI උපකරණ, ගෝලීයව ස්ථාපනය කළ යුතුය.

npm install -g package-name

උදාහරණය: http-server ගෝලීයව ස්ථාපනය

sudo npm install -g http-server

Ubuntu හි, -g භාවිතය sudo අවශ්‍ය විය හැකිය.

පැකේජ් ඉවත් කිරීම

දේශීය පැකේජ් ඉවත් කිරීම

npm uninstall package-name

ගෝලීය පැකේජ් ඉවත් කිරීම

sudo npm uninstall -g package-name

පැකේජ් යාවත්කාලීන කිරීම

විශේෂිත පැකේජයක් යාවත්කාලීන කිරීම

npm update package-name

සියලුම යැපීම් යාවත්කාලීන කිරීම

npm update

යාවත්කාලීන package.json හි නිර්දේශිත වර්ෂණ පරාසයන් තුළ යෙදෙන බැවින්, වර්ෂණ සීමාවන්ට අවධානය යොමු කරන්න.

සංවර්ධන යැපීම් ස්ථාපනය (–save-dev)

පරීක්ෂණ හෝ ගොඩනැගීමේ මෙවලම් වැනි සංවර්ධන පමණක් සඳහා පැකේජ් --save-dev විකල්පය භාවිතයෙන් ස්ථාපනය කළ යුතුය.

npm install --save-dev package-name

උදාහරණය: jest සංවර්ධන යැපීමක් ලෙස ස්ථාපනය

npm install --save-dev jest

මෙය package.json හි devDependencies යටතේ පැකේජය ලියාපදිංචි කරයි.

ස්ථාපිත පැකේජ් ලැයිස්තුගත කිරීම

දේශීය පැකේජ් ලැයිස්තුගත කිරීම

npm list

ගෝලීය පැකේජ් ලැයිස්තුගත කිරීම

npm list -g --depth=0

--depth=0 භාවිතයෙන් ඉහළ මට්ටමේ පැකේජ් පමණක් පෙන්වන අතර, ප්‍රතිදානය කියවීමට පහසු කරයි.

package.json භාවිතයෙන් යැපීම් කළමනාකරණය

package.json ගොනුව npm පාදක ව්‍යාපෘතිවල මූලික සංරචකයකි. එය පැකේජ් නාම, වර්ෂණ, ස්ක්‍රිප්ට් සහ සමස්ත ව්‍යාපෘති සැකසුම් ලියාපදිංචි කරයි.

එය නිර්මාණය කළ හැකිය:

npm init

අඩුවෙරු සැකසුමක් සමඟ සකස්‍ය වටිනාකොටස් සහිතව:

npm init -y

4. සුලබ ගැටලු සහ විසඳුම්

Ubuntu හි npm භාවිතා කිරීමේදී, දෝෂ හෝ අනපේක්ෂිත හැසිරීම් මුහුණ දීමට ඔබට සිදුවිය හැකිය. මෙම කොටසෙහි සුලබ ගැටලු සහ ඒවා විසඳීමේ ක්‍රම හඳුන්වා දෙයි.

අවසර දෝෂ

රෝග ලක්ෂණ

EACCES: permission denied

හේතුව

මෙය වත්මන් පරිශීලකයාට npm පැකේජ් ස්ථාපනය කරන්න උත්සාහ කරන නාමාවලිය සඳහා ලිවීමේ අවසර නොමැති විට සිදුවේ. Ubuntu හි, /usr/lib/node_modules වැනි පද්ධති නාමාවලියන්ට ලිවීමට sudo අවශ්‍ය වේ.

විසඳුම

  • sudo සමඟ ධාවනය:
    sudo npm install -g package-name
    
  • හෝ ගෝලීය ස්ථාපන නාමාවලිය පරිශීලක හිමි නාමාවලියකට වෙනස් කිරීම:
    mkdir ~/.npm-global
    npm config set prefix '~/.npm-global'
    

~/.bashrc හෝ ~/.profile හි පහත සඳහන් එකතු කරන්න:

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

වෙනස්කම් යෙදීම:

source ~/.bashrc

npm ප්‍රකාශනය සොයාගත නොහැක

රෝග ලක්ෂණ

command not found: npm

හේතුව

  • Node.js හෝ npm ස්ථාපනය අසාර්ථක වී ඇත
  • PATH පරිසර විචල්‍යය සකස් නොවී ඇත

විසඳුම

මාර්ගය පරීක්ෂා කරන්න:

which npm

කිසිවක් නොපෙන්වන්නේ නම්, නැවත ස්ථාපනය කරන්න හෝ PATH සැකසුම් සත්‍යාපනය කරන්න. nvm භාවිතා කරන්නේ නම්, ඔබේ shell සැකසුම් ගොනුවේ ආරම්භකාරක කේතය පවතින බව සහතික කරන්න:

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

පැකේජ් ස්ථාපන අසාර්ථකත්වයන් හෝ වර්ෂණ ගැටලු

රෝග ලක්ෂණ

with translations.* පැකේජයක් ස්ථාපනය කරන විට අනුවාද ගැටලු * npm install ක්‍රියාත්මක කිරීමේදී බොහෝ අනතුරු ඇඟවීම්

විසඳුම්

npm install package-name@latest
npm ls package-name
npm install --legacy-peer-deps
rm -rf node_modules package-lock.json
npm install

ප්‍රයෝජනවත් දෝෂ නිරාකරණ විධාන

  • npm doctor
    npm doctor
    
  • npm audit
    npm audit
    npm audit fix
    

5. නිතර අසන ප්‍රශ්න (FAQ)

ප්‍ර.1. Ubuntu හි npm නවතම අනුවාදයට යාවත්කාලීන කර ගැනීමට මොකක්ද කරන්නේ?

පි.1.

sudo npm install -g npm@latest

ඔබ nvm භාවිතා කරන්නේ නම්, sudo අවශ්‍ය නොවේ.

ප්‍ර.2. ගෝලීය සහ ස්ථානීය ස්ථාපනය අතර වෙනස කුමක්ද?

පි.2.

  • ස්ථානීය ස්ථාපනය : node_modules තුළ ගබඩා කරන ලද ව්‍යාපෘති-විශේෂිත පරාමිතීන්
  • ගෝලීය ස්ථාපනය : පද්ධතිය පුරා CLI මෙවලම්, සාමාන්‍යයෙන් sudo අවශ්‍ය වේ

ප්‍ර.3. nvm භාවිතා කිරීමේ ප්‍රතිලාභ මොනවාද?

පි.3.

nvm ඔබට බහු Node.js අනුවාද අතර ආරක්ෂිතව සහ කාර්යක්ෂමව මාරු වීමට ඉඩ දේ, බහු-ව්‍යාපෘති සංවර්ධනය සඳහා ඉතා සුදුසු වේ.

ප්‍ර.4. npm පරාමිතීන් බිඳී ගියහොත් මොකක්ද කළ යුතුද?

පි.4.

rm -rf node_modules package-lock.json
npm install

ප්‍ර.5. npm WARN සහ audit පණිවුඩයන් ගැටළුවක්ද?

පි.5.

අනතුරු ඇඟවීම් මරණාත්මක නොවන නමුත් සම්භාව්‍ය ගැටළු පෙන්වයි. ආරක්ෂණ-සම්බන්ධ අනතුරු ඇඟවීම් සඳහා, ඔබට මෙසේ උත්සාහ කළ හැක:

npm audit fix

ප්‍ර.6. Ubuntu හි npm සමඟ ඔබට මොනවාද ගොඩනැගිය හැක්කේ?

පි.6.

  • ඉදිරිපස රාමුව (React, Vue, Svelte)
  • ස්ථාවර වෙබ් අඩවි ජනක (Next.js, Nuxt)
  • පසුපස යෙදුම් (Express, NestJS)
  • CLI මෙවලම්
  • පරීක්ෂණ පරිසර

6. නිගමනය: Ubuntu හි npm පාලනය කරන්න

මෙම ලිපිය Ubuntu හි npm ස්ථාපනය කිරීම සහ භාවිතා කිරීමේ මූලික කරුණු, සැකසීම සිට දෝෂ නිරාකරණය දක්වා ආවරණය කරයි.

අතිශය වැදගත් පියවර වන්නේ ප්‍රායෝගිකව පරීක්ෂා කිරීමයි. විධාන ක්‍රියාත්මක කර දෝෂ පණිවුඩ තේරුම් ගැනීමෙන්, ඔබගේ සංවර්ධක කුසලතා පියවරෙන් පියවර වැඩිදියුණු කර ගත හැක.

මෙය Ubuntu හි npm භාවිතය පිළිබඳ සම්පූර්ණ මාර්ගෝපදේශය අවසන් කරයි. ඔබට වැඩි කාර්යක්ෂම සහ බලවත් සංවර්ධන පරිසරයක් ගොඩනැගීමට මෙය උපකාරී වේ යැයි අපි බලාපොරොත්තු වෙමු.