npm (Node Package Manager) ni zana chaguo-msingi la Node kwa kusakinisha na kudhibiti mifumo ya pande tatu (utegemezi) na kuendesha hati za mradi. Faili mbili hufafanua mradi: package.json (muhuri) na package-lock.json (mti kamili wa utegemezi).
Hujaza metadata, hati na utegemezi. ^4.18.0 ni mbalimbali ya semver — ^ inaruhusu sasisho linganishi la ndogo/kiboreshaji (4.x.x lakini si 5.0.0).
package.json says: express ^4.18.0 (a RANGE — could install 4.18.0 or 4.19.2...)
package-lock.json: express 4.18.2 (the EXACT version + every nested dependency)
Faili ya kufuli inatatiza halisi toleo la kila mifumo (ikiwa ni pamoja na utegemezi wa mpito) uliosakinishwa. Hii inahakikisha kwamba kila mtu kwenye timu — na CI, na uzalishaji — hupokea mti wa utegemezi sawa sawa, kukaribisha hitilafu "inafanya kazi kwenye kompyuta yangu" kutoka kwa kubadilika kwa toleo.
npm install # install all deps from package.json (updates lockfile)
npm install express # add a dependency
npm install -D vitest # add a devDependency
npm ci # install EXACTLY from the lockfile (used in CI — fast, strict)
npm run dev # run a script defined in package.json
npm ci (dhidi ya npm install) hiyo husakinisha haswa kutoka kwa faili ya kufuli bila kuibadilisha — amri sahihi kwa kurudiwa kwa CI/uzalishaji.
✓ ALWAYS commit package-lock.json → reproducible installs across the team & CI
npm na faili hizi mbili ni msingi wa kila mradi wa Node.
Kufahamu package.json (utegemezi dhidi ya devDependencies, mbalimbali ya semver, hati) na hasa kwa nini faili ya kufuli ipo (usakinishaji kamili, unaorudiwa wa mti mzima wa utegemezi) ni muhimu — kuzitolea faili ya kufuli na kutumia npm ci katika CI inazuia kupuka kwa meno, kukaribisha hitilafu iliyosababishwa na wenzako au uzalishaji kupokea toleo tofauti la mifumo.